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, 113 insertions, 0 deletions

diff --git a/doc/source/cli/command-objects/credential.rst b/doc/source/cli/command-objects/credential.rst
new file mode 100644
index 00000000..0b835c73
--- /dev/null
+++ b/doc/source/cli/command-objects/credential.rst
@@ -0,0 +1,113 @@
+==========
+credential
+==========
+
+Identity v3
+
+credential create
+-----------------
+
+Create new credential
+
+.. program:: credential create
+.. code:: bash
+
+    openstack credential create
+        [--type <type>]
+        [--project <project>]
+        <user> <data>
+
+.. option:: --type <type>
+
+    New credential type
+
+.. option:: --project <project>
+
+    Project which limits the scope of the credential (name or ID)
+
+.. _credential_create:
+.. describe:: <user>
+
+    User that owns the credential (name or ID)
+
+.. describe:: <data>
+
+    New credential data
+
+credential delete
+-----------------
+
+Delete credential(s)
+
+.. program:: credential delete
+.. code:: bash
+
+    openstack credential delete
+        <credential-id> [<credential-id> ...]
+
+.. _credential_delete:
+.. describe:: <credential-id>
+
+    ID(s) of credential to delete
+
+credential list
+---------------
+
+List credentials
+
+.. program:: credential list
+.. code:: bash
+
+    openstack credential list
+
+credential set
+--------------
+
+Set credential properties
+
+.. program:: credential set
+.. code:: bash
+
+    openstack credential set
+        [--user <user>]
+        [--type <type>]
+        [--data <data>]
+        [--project <project>]
+        <credential-id>
+
+.. option:: --user <user>
+
+    User that owns the credential (name or ID)
+
+.. option:: --type <type>
+
+    New credential type
+
+.. option:: --data <data>
+
+    New credential data
+
+.. option:: --project <project>
+
+    Project which limits the scope of the credential (name or ID)
+
+.. _credential_set:
+.. describe:: <credential-id>
+
+    ID of credential to change
+
+credential show
+---------------
+
+Display credential details
+
+.. program:: credential show
+.. code:: bash
+
+    openstack credential show
+        <credential-id>
+
+.. _credential_show:
+.. describe:: <credential-id>
+
+    ID of credential to display