diff --git a/doc/source/shared/_includes/cli-ref-intro-software.rest b/doc/source/shared/_includes/cli-ref-intro-software.rest
new file mode 100644
index 000000000..29ce76927
--- /dev/null
+++ b/doc/source/shared/_includes/cli-ref-intro-software.rest
@@ -0,0 +1,13 @@
+.. include:: /shared/_includes/uline.rest
+
+:command:`software` is the command-line interface for the |VIM| Orchestration
+APIs.
+
+This page documents the :command:`software` command.
+
+For a full description of usage and optional arguments for a specific
+:command:`software` command, enter:
+
+.. code-block::
+
+   ~(keystone_admin)]$ software <command> -h