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

diff --git a/doc/source/cli/command-objects/aggregate.rst b/doc/source/cli/command-objects/aggregate.rst
new file mode 100644
index 00000000..2029a6c8
--- /dev/null
+++ b/doc/source/cli/command-objects/aggregate.rst
@@ -0,0 +1,186 @@
+=========
+aggregate
+=========
+
+Host aggregates provide a mechanism to group hosts according to certain
+criteria.
+
+Compute v2
+
+aggregate add host
+------------------
+
+Add host to aggregate
+
+.. program:: aggregate add host
+.. code:: bash
+
+    openstack aggregate add host
+        <aggregate>
+        <host>
+
+.. _aggregate_add_host-aggregate:
+.. describe:: <aggregate>
+
+    Aggregate (name or ID)
+
+.. _aggregate_add_host-host:
+.. describe:: <host>
+
+    Host to add to :ref:`\<aggregate\> <aggregate_add_host-aggregate>`
+
+aggregate create
+----------------
+
+Create a new aggregate
+
+.. program:: aggregate create
+.. code:: bash
+
+    openstack aggregate create
+        [--zone <availability-zone>]
+        [--property <key=value> [...] ]
+        <name>
+
+.. option:: --zone <availability-zone>
+
+    Availability zone name
+
+.. option:: --property <key=value>
+
+    Property to add to this aggregate (repeat option to set multiple properties)
+
+.. _aggregate_create-name:
+.. describe:: <name>
+
+    New aggregate name
+
+aggregate delete
+----------------
+
+Delete existing aggregate(s)
+
+.. program:: aggregate delete
+.. code:: bash
+
+    openstack aggregate delete
+        <aggregate> [<aggregate> ...]
+
+.. _aggregate_delete-aggregate:
+.. describe:: <aggregate>
+
+    Aggregate(s) to delete (name or ID)
+
+aggregate list
+--------------
+
+List all aggregates
+
+.. program:: aggregate list
+.. code:: bash
+
+    openstack aggregate list
+        [--long]
+
+.. option:: --long
+
+    List additional fields in output
+
+aggregate remove host
+---------------------
+
+Remove host from aggregate
+
+.. program:: aggregate remove host
+.. code:: bash
+
+    openstack aggregate remove host
+        <aggregate>
+        <host>
+
+.. _aggregate_remove_host-aggregate:
+.. describe:: <aggregate>
+
+    Aggregate (name or ID)
+
+.. _aggregate_remove_host-host:
+.. describe:: <host>
+
+    Host to remove from :ref:`\<aggregate\> <aggregate_remove_host-aggregate>`
+
+aggregate set
+-------------
+
+Set aggregate properties
+
+.. program:: aggregate set
+.. code:: bash
+
+    openstack aggregate set
+        [--name <new-name>]
+        [--zone <availability-zone>]
+        [--property <key=value> [...] ]
+        [--no-property]
+        <aggregate>
+
+.. option:: --name <name>
+
+    Set aggregate name
+
+.. option:: --zone <availability-zone>
+
+    Set availability zone name
+
+.. option:: --property <key=value>
+
+    Property to set on :ref:`\<aggregate\> <aggregate_set-aggregate>`
+    (repeat option to set multiple properties)
+
+.. option:: --no-property
+
+    Remove all properties from :ref:`\<aggregate\> <aggregate_set-aggregate>`
+    (specify both :option:`--property` and :option:`--no-property` to
+    overwrite the current properties)
+
+.. _aggregate_set-aggregate:
+.. describe:: <aggregate>
+
+    Aggregate to modify (name or ID)
+
+aggregate show
+--------------
+
+Display aggregate details
+
+.. program:: aggregate show
+.. code:: bash
+
+    openstack aggregate show
+        <aggregate>
+
+.. _aggregate_show-aggregate:
+.. describe:: <aggregate>
+
+    Aggregate to display (name or ID)
+
+aggregate unset
+---------------
+
+Unset aggregate properties
+
+.. program:: aggregate unset
+.. code-block:: bash
+
+    openstack aggregate unset
+        [--property <key> [...] ]
+        <aggregate>
+
+.. option:: --property <key>
+
+    Property to remove from :ref:`\<aggregate\> <aggregate_unset-aggregate>`
+    (repeat option to remove multiple properties)
+
+.. _aggregate_unset-aggregate:
+.. describe:: <aggregate>
+
+    Aggregate to modify (name or ID)