diff --git a/cli/documentation/en_US/debug/bash b/cli/documentation/en_US/debug/bash
new file mode 100755
index 0000000..31ad385
--- /dev/null
+++ b/cli/documentation/en_US/debug/bash
@@ -0,0 +1 @@
+The bash choices opens a nested bash shell.
diff --git a/cli/documentation/en_US/debug/cli b/cli/documentation/en_US/debug/cli
new file mode 100755
index 0000000..cbc7df1
--- /dev/null
+++ b/cli/documentation/en_US/debug/cli
@@ -0,0 +1,12 @@
+cli choices for the debug command enables various
+different cli features.  First the cli will
+provide details about internal failures, which is
+intended to provide a detailed description for
+some failure.  Failures may occur not only in the
+execution of commands, but while building the
+command, for example during the generation of
+completion choices.  Second, the cli option also
+enables direct editing of many of the underlying
+models (database tables) exported by the REST API.
+This feature is intended to provide a way to view
+or modify the internal contents of the database.
diff --git a/cli/documentation/en_US/debug/cli-backtrace b/cli/documentation/en_US/debug/cli-backtrace
new file mode 100755
index 0000000..fad29c3
--- /dev/null
+++ b/cli/documentation/en_US/debug/cli-backtrace
@@ -0,0 +1,5 @@
+The cli-backtrace enables additional output during
+cli failures, displaying a backtrace.  The
+difference between cli-backtrace and the cli
+choice is that the model (database tables) editing
+features are not enabled
diff --git a/cli/documentation/en_US/debug/cli-batch b/cli/documentation/en_US/debug/cli-batch
new file mode 100755
index 0000000..bcc761c
--- /dev/null
+++ b/cli/documentation/en_US/debug/cli-batch
@@ -0,0 +1,2 @@
+The batch choice enables batch mode within the
+cli.   No prompts will be requested from the user
diff --git a/cli/documentation/en_US/debug/debug-cli b/cli/documentation/en_US/debug/debug-cli
new file mode 100755
index 0000000..9bc4f7a
--- /dev/null
+++ b/cli/documentation/en_US/debug/debug-cli
@@ -0,0 +1,7 @@
+The debug command enables and disables various settings intended to 
+describe the cli's own behavior.   In addition, some of the choices
+allow nested invocation of various other tools, intended to debug
+various related controller components, for example, 'debug cassandra-cli'
+is intended to enter the cassandra cli to view internal database state,
+and 'debug bash' is intended to enter a bash subshell to gain access to
+the internal environment of the controller.  
diff --git a/cli/documentation/en_US/debug/debug-cli-example b/cli/documentation/en_US/debug/debug-cli-example
new file mode 100755
index 0000000..e5a2c6a
--- /dev/null
+++ b/cli/documentation/en_US/debug/debug-cli-example
@@ -0,0 +1,11 @@
+debug rest
+  Enable rest api output
+
+debug rest detail
+  Enable rest api output, and also display replies from the rest api calls
+
+debug cli
+  Enable debugging mode for the cli
+
+debug bash
+  Open a bash subshell
diff --git a/cli/documentation/en_US/debug/description b/cli/documentation/en_US/debug/description
new file mode 100755
index 0000000..5262201
--- /dev/null
+++ b/cli/documentation/en_US/debug/description
@@ -0,0 +1,7 @@
+The description choice enables additional output
+to display the internal execution of command
+descriptions.  The option is intended to help
+debug the cli's command descriptions.  It will not
+only enable output for command execution, but also
+enable output while performing command completion
+choices for commands.
diff --git a/cli/documentation/en_US/debug/rest b/cli/documentation/en_US/debug/rest
new file mode 100755
index 0000000..e031896
--- /dev/null
+++ b/cli/documentation/en_US/debug/rest
@@ -0,0 +1,5 @@
+The rest choice enables printing of additional
+output when the cli issues any REST API calls.
+The command is valuable since it can provide an
+indication of what operations are being performed
+by the cli to perform the requested command.