docs: update desciptions to include multi line arguments (#326)

* docs: update desciptions to include multi line arguments

* fix: lint issues

Author: brivu

src/commands/build_and_push_image.yml

@@ -119,8 +119,9 @@ parameters:
   extra_build_args:
     default: ""
     description: >
-      Extra flags to pass to docker build. For examples, see
-      https://docs.docker.com/engine/reference/commandline/build
+      Extra flags to pass to docker build. This parameter accepts multi-line arguments.
+      If your argument spans multiple lines, please use the Folded Block Style denoted by `>-` (e.g. extra_build_args: >-).
+      For examples of available flags, see https://docs.docker.com/engine/reference/commandline/buildx_build
     type: string
 
   no_output_timeout:

src/commands/build_image.yml

@@ -42,11 +42,12 @@ parameters:
     description: The amount of time to allow the docker command to run before timing out.
 
   extra_build_args:
-    type: string
     default: ""
     description: >
-      Extra flags to pass to docker build. For examples, see
-      https://docs.docker.com/engine/reference/commandline/buildx
+      Extra flags to pass to docker build. This parameter accepts multi-line arguments.
+      If your argument spans multiple lines, please use the Folded Block Style denoted by `>-` (e.g. extra_build_args: >-).
+      For examples of available flags, see https://docs.docker.com/engine/reference/commandline/buildx_build
+    type: string
 
   skip_when_tags_exist:
     type: boolean

src/jobs/build_and_push_image.yml

@@ -128,11 +128,12 @@ parameters:
     type: string
 
   extra_build_args:
-    type: string
     default: ""
     description: >
-      Extra flags to pass to docker build. For examples, see
-      https://docs.docker.com/engine/reference/commandline/build
+      Extra flags to pass to docker build. This parameter accepts multi-line arguments.
+      If your argument spans multiple lines, please use the Folded Block Style denoted by `>-` (e.g. extra_build_args: >-).
+      For examples of available flags, see https://docs.docker.com/engine/reference/commandline/buildx_build
+    type: string
 
   no_output_timeout:
     type: string