diff --git a/docs/reference/commandline/service_create.md b/docs/reference/commandline/service_create.md
index c265205c09615a65108572e0b8110ad89bd938e7..d5df309bbb594e7a43155411791e204a7ceffbd6 100644
--- a/docs/reference/commandline/service_create.md
+++ b/docs/reference/commandline/service_create.md
@@ -40,7 +40,7 @@ Options:
       --restart-window value         Window used to evaluate the restart policy (default none)
       --stop-grace-period value      Time to wait before force killing a container (default none)
       --update-delay duration        Delay between updates
-      --update-parallelism uint      Maximum number of tasks updated simultaneously
+      --update-parallelism uint      Maximum number of tasks updated simultaneously (0 to update all at once) (default 1)
   -u, --user string                  Username or UID
       --with-registry-auth           Send registry authentication details to Swarm agents
   -w, --workdir string               Working directory inside the container
diff --git a/docs/reference/commandline/service_update.md b/docs/reference/commandline/service_update.md
index 25817e115c3aa20b051c25fc0b696cf644a4317c..2405dd40906f78ce84dd21cfda044999eb6c67a0 100644
--- a/docs/reference/commandline/service_update.md
+++ b/docs/reference/commandline/service_update.md
@@ -47,7 +47,7 @@ Options:
       --restart-window value         Window used to evaluate the restart policy (default none)
       --stop-grace-period value      Time to wait before force killing a container (default none)
       --update-delay duration        Delay between updates
-      --update-parallelism uint      Maximum number of tasks updated simultaneously
+      --update-parallelism uint      Maximum number of tasks updated simultaneously (0 to update all at once) (default 1)
   -u, --user string                  Username or UID
       --with-registry-auth           Send registry authentication details to Swarm agents
   -w, --workdir string               Working directory inside the container
diff --git a/docs/swarm/swarm-tutorial/drain-node.md b/docs/swarm/swarm-tutorial/drain-node.md
index 127fe42bc8cdb7823f647cfe4df145563d5ce4f7..bd6ce73b9ea2b56297f95d68016015fe4995a7ea 100644
--- a/docs/swarm/swarm-tutorial/drain-node.md
+++ b/docs/swarm/swarm-tutorial/drain-node.md
@@ -41,7 +41,7 @@ run your manager node. For example, the tutorial uses a machine named
 update](rolling-update.md) tutorial, start it now:
 
     ```bash
-    $ docker service create --replicas 3 --name redis --update-delay 10s --update-parallelism 1 redis:3.0.6
+    $ docker service create --replicas 3 --name redis --update-delay 10s redis:3.0.6
 
     c5uo6kdmzpon37mgj9mwglcfw
     ```