Address review comments

Signed-off-by: Chenxiong Qi <[email protected]>

Author: tkdchen

docs/modules/ROOT/pages/how-tos/configuring/build-with-args.adoc

@@ -1,6 +1,6 @@
 = Passing buildah arguments
 
-{ProductName} buildah task accepts link:https://github.com/konflux-ci/build-definitions/blob/main/task/buildah/0.1/buildah.yaml#L78[`BUILD_ARGS` parameter] that allows passing build arguments to the underlying `buildah` command via `--build-arg` flag. To do this, make the following changes to the PipelineRuns under the `.tekton/` directory:
+{ProductName} buildah task accepts link:https://github.com/konflux-ci/build-definitions/blob/main/task/buildah/0.1/buildah.yaml#L78[`BUILD_ARGS` parameter] that allows passing build arguments to the underlying `buildah` command through `--build-arg` flag. To enable this, make the following changes to the PipelineRuns under the `.tekton/` directory:
 
 . Define a `build-args` Pipeline parameter (if not already present) in `.spec.pipelineSpec.params` to accept the passed-in build arguments.
 
@@ -38,7 +38,7 @@ spec:
 The value can also be in form `tasks.<taskName>.results.<resultName>[*]` if it is generated by another task dynamically.
 
 +
-An advanced example of it would be, you can do more creative things with the `BUILD_ARGS` parameter like this snippet of a pipeline that allows passing `build-args` via the pipeline parameter (as described above) but also incorporates `build-args` generated dynamically by other tasks:
+For example, you can do more creative things with the `BUILD_ARGS` parameter like this snippet of a pipeline that allows passing `build-args` through the pipeline parameter (as described above) but also incorporates `build-args` generated dynamically by other tasks:
 
 +
 [source,yaml]
@@ -62,9 +62,9 @@ spec:
 --
 
 +
-Please note that the value of `BUILD_ARGS` is in the correct syntax described in link:https://tekton.dev/docs/pipelines/variables/[Variable Substitutions Supported by Tasks and Pipelines].
+NOTE: Ensure that the value of `BUILD_ARGS` has the correct syntax as described in link:https://tekton.dev/docs/pipelines/variables/[Variable Substitutions Supported by Tasks and Pipelines].
 
-. Pass desired build arguments in the PipelineRun `.spec.params`:
+. Pass the desired build arguments in the PipelineRun `.spec.params`:
 
 +
 [source,yaml]
@@ -73,8 +73,5 @@ spec:
   params:
   # ...
   - name: build-args
-    value: ["ARG1=val", "ARG2=val"]
+    value: ["ARG1=val", "ARG2=val"]  # Add real argument name and value of each build argument
 --
-
-+
-Replace with real argument name and value of each build argument.