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

diff --git a/doc/source/command-objects/role.rst b/doc/source/command-objects/role.rst
deleted file mode 100644
index fe3126c0..00000000
--- a/doc/source/command-objects/role.rst
+++ /dev/null
@@ -1,326 +0,0 @@
-====
-role
-====
-
-Identity v2, v3
-
-role add
---------
-
-Add role assignment to a user or group in a project or domain
-
-.. program:: role add
-.. code:: bash
-
-    openstack role add
-        --domain <domain> | --project <project> [--project-domain <project-domain>]
-        --user <user> [--user-domain <user-domain>] | --group <group> [--group-domain <group-domain>]
-        --role-domain <role-domain>
-        --inherited
-        <role>
-
-.. option:: --domain <domain>
-
-    Include <domain> (name or ID)
-
-    .. versionadded:: 3
-
-.. option:: --project <project>
-
-    Include <project> (name or ID)
-
-.. option:: --user <user>
-
-    Include <user> (name or ID)
-
-.. option:: --group <group>
-
-    Include <group> (name or ID)
-
-    .. versionadded:: 3
-
-.. option:: --user-domain <user-domain>
-
-    Domain the user belongs to (name or ID).
-    This can be used in case collisions between user names exist.
-
-    .. versionadded:: 3
-
-.. option:: --group-domain <group-domain>
-
-    Domain the group belongs to (name or ID).
-    This can be used in case collisions between group names exist.
-
-    .. versionadded:: 3
-
-.. option:: --project-domain <project-domain>
-
-    Domain the project belongs to (name or ID).
-    This can be used in case collisions between project names exist.
-
-    .. versionadded:: 3
-
-.. option:: --inherited
-
-    Specifies if the role grant is inheritable to the sub projects.
-
-    .. versionadded:: 3
-
-.. option:: --role-domain <role-domain>
-
-    Domain the role belongs to (name or ID).
-    This must be specified when the name of a domain specific role is used.
-
-    .. versionadded:: 3
-
-.. describe:: <role>
-
-    Role to add to <project>:<user> (name or ID)
-
-role create
------------
-
-Create new role
-
-.. program:: role create
-.. code:: bash
-
-    openstack role create
-        [--or-show]
-        [--domain <domain>]
-        <name>
-
-.. option:: --domain <domain>
-
-    Domain the role belongs to (name or ID).
-
-    .. versionadded:: 3
-
-.. option:: --or-show
-
-    Return existing role
-
-    If the role already exists return the existing role data and do not fail.
-
-.. describe:: <name>
-
-    New role name
-
-role delete
------------
-
-Delete role(s)
-
-.. program:: role delete
-.. code:: bash
-
-    openstack role delete
-        <role> [<role> ...]
-        [--domain <domain>]
-
-.. describe:: <role>
-
-    Role to delete (name or ID)
-
-.. option:: --domain <domain>
-
-    Domain the role belongs to (name or ID).
-
-    .. versionadded:: 3
-
-role list
----------
-
-List roles
-
-.. program:: role list
-.. code:: bash
-
-    openstack role list
-        --domain <domain> | --project <project> [--project-domain <project-domain>]
-        --user <user> [--user-domain <user-domain>] | --group <group> [--group-domain <group-domain>]
-        --inherited
-
-.. option:: --domain <domain>
-
-    Filter roles by <domain> (name or ID)
-
-    (Deprecated if being used to list assignments in conjunction with the
-    ``--user <user>``, option, please use ``role assignment list`` instead)
-
-.. option:: --project <project>
-
-    Filter roles by <project> (name or ID)
-
-    (Deprecated, please use ``role assignment list`` instead)
-
-.. option:: --user <user>
-
-    Filter roles by <user> (name or ID)
-
-    (Deprecated, please use ``role assignment list`` instead)
-
-.. option:: --group <group>
-
-    Filter roles by <group> (name or ID)
-
-    (Deprecated, please use ``role assignment list`` instead)
-
-.. option:: --user-domain <user-domain>
-
-    Domain the user belongs to (name or ID).
-    This can be used in case collisions between user names exist.
-
-    (Deprecated, please use ``role assignment list`` instead)
-
-    .. versionadded:: 3
-
-.. option:: --group-domain <group-domain>
-
-    Domain the group belongs to (name or ID).
-    This can be used in case collisions between group names exist.
-
-    (Deprecated, please use ``role assignment list`` instead)
-
-    .. versionadded:: 3
-
-.. option:: --project-domain <project-domain>
-
-    Domain the project belongs to (name or ID).
-    This can be used in case collisions between project names exist.
-
-    (Deprecated, please use ``role assignment list`` instead)
-
-    .. versionadded:: 3
-
-.. option:: --inherited
-
-    Specifies if the role grant is inheritable to the sub projects.
-
-    (Deprecated, please use ``role assignment list`` instead)
-
-    .. versionadded:: 3
-
-role remove
------------
-
-Remove role assignment from domain/project : user/group
-
-.. program:: role remove
-.. code:: bash
-
-    openstack role remove
-        --domain <domain> | --project <project> [--project-domain <project-domain>]
-        --user <user> [--user-domain <user-domain>] | --group <group> [--group-domain <group-domain>]
-        --role-domain <role-domain>
-        --inherited
-        <role>
-
-.. option:: --domain <domain>
-
-    Include <domain> (name or ID)
-
-    .. versionadded:: 3
-
-.. option:: --project <project>
-
-    Include <project> (name or ID)
-
-.. option:: --user <user>
-
-    Include <user> (name or ID)
-
-.. option:: --group <group>
-
-    Include <group> (name or ID)
-
-    .. versionadded:: 3
-
-.. option:: --user-domain <user-domain>
-
-    Domain the user belongs to (name or ID).
-    This can be used in case collisions between user names exist.
-
-    .. versionadded:: 3
-
-.. option:: --group-domain <group-domain>
-
-    Domain the group belongs to (name or ID).
-    This can be used in case collisions between group names exist.
-
-    .. versionadded:: 3
-
-.. option:: --project-domain <project-domain>
-
-    Domain the project belongs to (name or ID).
-    This can be used in case collisions between project names exist.
-
-    .. versionadded:: 3
-
-.. option:: --inherited
-
-    Specifies if the role grant is inheritable to the sub projects.
-
-    .. versionadded:: 3
-
-.. option:: --role-domain <role-domain>
-
-    Domain the role belongs to (name or ID).
-    This must be specified when the name of a domain specific role is used.
-
-    .. versionadded:: 3
-
-.. describe:: <role>
-
-    Role to remove (name or ID)
-
-role set
---------
-
-Set role properties
-
-.. versionadded:: 3
-
-.. program:: role set
-.. code:: bash
-
-    openstack role set
-        [--name <name>]
-        [--domain <domain>]
-        <role>
-
-.. option:: --name <name>
-
-    Set role name
-
-.. option:: --domain <domain>
-
-    Domain the role belongs to (name or ID).
-
-    .. versionadded:: 3
-
-.. describe:: <role>
-
-    Role to modify (name or ID)
-
-role show
----------
-
-Display role details
-
-.. program:: role show
-.. code:: bash
-
-    openstack role show
-        [--domain <domain>]
-        <role>
-
-.. option:: --domain <domain>
-
-    Domain the role belongs to (name or ID).
-
-    .. versionadded:: 3
-
-.. describe:: <role>
-
-    Role to display (name or ID)