diff --git a/commands/command b/commands/command
index b35501f1bf8..f1a48922122 100644
--- a/commands/command
+++ b/commands/command
@@ -39,7 +39,8 @@ description:
 options:
   free_form:
     description:
-      - the command module takes a free form command to run
+      - the command module takes a free form command to run.  There is no parameter actually named 'free form'.
+        See the examples!
     required: true
     default: null
     aliases: []
diff --git a/commands/shell b/commands/shell
index 03299b967cc..639d4a14b09 100644
--- a/commands/shell
+++ b/commands/shell
@@ -14,7 +14,8 @@ version_added: "0.2"
 options:
   free_form:
     description:
-      - The shell module takes a free form command to run
+      - The shell module takes a free form command to run, as a string.  There's not an actual
+        option named "free form".  See the examples!
     required: true
     default: null
   creates: