reorganize existing documentation according to the new standard layout

Move existing content around based on the doc-migration specification.

Replace :doc: markup with :ref: to have sphinx keep track of where the
files move and generate valid hyperlinks.

Add a few toctrees and index pages for the new directories.

Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454
Change-Id: I253ee8f89d3ec40e39310c18bb87ed1d3d5de330
Signed-off-by: Doug Hellmann <doug@doughellmann.com>

1 files changed, 58 insertions, 0 deletions

diff --git a/doc/source/cli/command-objects/extension.rst b/doc/source/cli/command-objects/extension.rst
new file mode 100644
index 00000000..36cf418b
--- /dev/null
+++ b/doc/source/cli/command-objects/extension.rst
@@ -0,0 +1,58 @@
+=========
+extension
+=========
+
+Many OpenStack server APIs include API extensions that enable
+additional functionality.
+
+extension list
+--------------
+
+List API extensions
+
+.. program:: extension list
+.. code:: bash
+
+    openstack extension list
+        [--compute]
+        [--identity]
+        [--network]
+        [--volume]
+        [--long]
+
+.. option:: --compute
+
+    List extensions for the Compute API
+
+.. option:: --identity
+
+    List extensions for the Identity API
+
+.. option:: --network
+
+    List extensions for the Network API
+
+.. option:: --volume
+
+    List extensions for the Block Storage API
+
+.. option:: --long
+
+    List additional fields in output
+
+extension show
+--------------
+
+Show API extension
+
+.. program:: extension show
+.. code:: bash
+
+    openstack extension show
+        <extension>
+
+.. _extension_show:
+.. describe:: <extension>
+
+   Extension to display. Currently, only network extensions are supported.
+   (Name or Alias)