diff --git a/README.md b/README.md
index ed8cbc5..93e717a 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,9 @@ jobs:
         with:
           push: true
           tags: user/app:latest
+          build-args: |
+            arg1=value1
+            arg2=value2
       -
         name: Image digest
         run: echo ${{ steps.docker_build.outputs.digest }}
@@ -540,8 +543,8 @@ might want to use:
 
 ### Update DockerHub repo description
 
-You can update the [Docker Hub repository description](https://docs.docker.com/docker-hub/repos/) using
-a third-party action called [Docker Hub Description](https://github.com/peter-evans/dockerhub-description)
+You can update the [DockerHub repository description](https://docs.docker.com/docker-hub/repos/) using
+a third-party action called [DockerHub Description](https://github.com/peter-evans/dockerhub-description)
 with this action:
 
 <details>
diff --git a/UPGRADE.md b/UPGRADE.md
index bda8509..95d9c6b 100644
--- a/UPGRADE.md
+++ b/UPGRADE.md
@@ -65,7 +65,9 @@ steps:
       file: ./Dockerfile
       pull: true
       push: true
-      build-args: arg1=value1,arg2=value2
+      build-args: |
+        arg1=value1
+        arg2=value2
       cache-from: type=registry,ref=myorg/myrepository:latest
       cache-to: type=inline
       tags: myorg/myrepository:latest