Merge pull request #32950 from dnephin/cherry-pick-build-arg-fixes
[17.05.x] Cherry pick build arg fixes
diff --git a/docs/deprecated.md b/docs/deprecated.md
index 8f6070a..7e0bfc0 100644
--- a/docs/deprecated.md
+++ b/docs/deprecated.md
@@ -20,6 +20,17 @@
To learn more about Docker Engine's deprecation policy,
see [Feature Deprecation Policy](https://docs.docker.com/engine/#feature-deprecation-policy).
+### Asynchronous `service create` and `service update`
+
+**Deprecated In Release: v17.05.0**
+
+**Disabled by default in release: v17.09**
+
+Docker 17.05.0 added an optional `--detach=false` option to make the
+`docker service create` and `docker service update` work synchronously. This
+option will be enable by default in Docker 17.09, at which point the `--detach`
+flag can be used to use the previous (asynchronous) behavior.
+
### `-g` and `--graph` flags on `dockerd`
**Deprecated In Release: v17.05.0**
