incorporate doc review comments

Signed-off-by: Madhav Puri <madhav.puri@gmail.com>
Upstream-commit: 8cfcd8738070f24bd66e3b7ed46c6459df3fa9a3
Component: engine

components/engine/docs/reference/api/docker_remote_api_v1.21.md

@@ -1367,11 +1367,11 @@ Query Parameters:
 -   **memswap** - Total memory (memory + swap), `-1` to disable swap.
 -   **cpushares** - CPU shares (relative weight).
 -   **cpusetcpus** - CPUs in which to allow execution (e.g., `0-3`, `0,1`).
--   **buildargs** – JSON map of string pairs for build-time variables. Users can
-        set these values at build-time and they are used as environment context
-        for the command(s) run as part of the Dockerfile's `RUN` instruction or
-        for variable expansion in other Dockerfile instructions. Read more about
-        the `ARG` instruction [here](/reference/builder/#arg)
+-   **buildargs** – JSON map of string pairs for build-time variables. Users pass
+        these values at build-time. Docker uses the `buildargs` as the environment
+        context for command(s) run via the Dockerfile's `RUN` instruction or for
+        variable expansion in other Dockerfile instructions. This is not meant for
+        passing secret values. [Read more about the buildargs instruction](/reference/builder/#arg)
 
     Request Headers: