From 344c73ac672cd4d4f70a08b5a41b6835d9873926 Mon Sep 17 00:00:00 2001
From: Jon Surrell <jon.surrell@gmail.com>
Date: Mon, 12 Feb 2018 14:02:54 +0100
Subject: [PATCH] Add example buildargs usage

Signed-off-by: Jon Surrell <jon.surrell@gmail.com>
---
 api/swagger.yaml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/api/swagger.yaml b/api/swagger.yaml
index 2262de6bfa..8174ce387c 100644
--- a/api/swagger.yaml
+++ b/api/swagger.yaml
@@ -6178,6 +6178,12 @@ paths:
             uses the buildargs as the environment context for commands run via the `Dockerfile` RUN
             instruction, or for variable expansion in other `Dockerfile` instructions. This is not meant for
             passing secret values.
+
+
+            For example, the build arg `FOO=bar` would become `{"FOO":"bar"}` in JSON. This would result in the
+            the query parameter `buildargs={"FOO":"bar"}`. Note that `{"FOO":"bar"}` should be URI component encoded.
+
+
             [Read more about the buildargs instruction.](https://docs.docker.com/engine/reference/builder/#arg)
           type: "string"
         - name: "shmsize"