diff --git a/sway/sway.5.scd b/sway/sway.5.scd
index 32631b06..29c1d0e5 100644
--- a/sway/sway.5.scd
+++ b/sway/sway.5.scd
@@ -699,6 +699,9 @@ The default colors are:
 	Specifies that workspace _name_ should have the given gaps settings when it
 	is created.
 
+	This command does not affect existing workspaces. To alter the gaps of an
+	existing workspace, use the _gaps_ command.
+
 *workspace* <name> output <outputs...>
 	Specifies that workspace _name_ should be shown on the specified _outputs_.
 	Multiple outputs can be listed and the first available will be used. If the
@@ -706,6 +709,11 @@ The default colors are:
 	is higher on the list becomes available, the workspace will be move to the
 	higher priority output.
 
+	This command does not affect existing workspaces. To move an existing
+	workspace, use the _move_ command in combination with the _workspace_
+	criteria (non-empty workspaces only) or _workspace_ command (to switch
+	to the workspace before moving).
+
 *workspace_auto_back_and_forth* yes|no
 	When _yes_, repeating a workspace switch command will switch back to the
 	prior workspace. For example, if you are currently on workspace 1,