docs: Restructure command-objects guide

These docs were initially structured based on the idea that commands
should be common across service versions. This has unfortunately broken
down over time and is no longer true, with an increasingly large
divergence between API implementations. Start splitting the docs out by
service version to bypass this.

Redirects are added to ensure we don't break any existing links in the
wild.

Change-Id: Iaf42bc5b92c811a42cbe450d21fdb5ae00f6f45b
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>

Author: stephenfin

doc/source/_extra/.htaccess

@@ -14,3 +14,13 @@ redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/plugin-commands.html$ /py
 # - image pages were split into -v1 and -v2
 # The unversioned page is hidden but contains links to the versioned pages so links in the wild redirect somewhere sane.
 redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/command-objects/(ec2-credentials|endpoint|image|project|role|service|token|user).html$ /python-openstackclient/$1/cli/_hidden/$2.html
+
+# Redirect docs from their previous flat structure to the new service/version structure
+redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/command-objects/(availability-zone|command|complete|configuration|extension|limits|module|project-cleanup|quota|versions)\.html$ /python-openstackclient/$1/cli/command-objects/common/index.html
+redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/command-objects/(aggregate|compute-agent|compute-service|console-connection|console-log|console-url|flavor|host|hypervisor-stats|hypervisor|keypair|server-backup|server-event|server-group|server-image|server-migration|server|usage)\.html$ /python-openstackclient/$1/cli/command-objects/compute/v2/index.html
+redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/command-objects/(ec2-credentials-v2|endpoint-v2|project-v2|role-v2|service-v2|token-v2|user-v2)\.html$ /python-openstackclient/$1/cli/command-objects/identity/v2/index.html
+redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/command-objects/(access-rules|access-token|application-credentials|catalog|consumer|credential|domain|ec2-credentials-v3|endpoint-v3|endpoint_group|federation-domain-project|federation-protocol|group|identity-provider|implied_role|limit|mapping|policy|project-v3|region|registered-limit|request-token|role-assignment|role-v3|service-provider|service-v3|token-v3|trust|user-v3)\.html$ /python-openstackclient/$1/cli/command-objects/identity/v3/index.html
+redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/command-objects/(image-member|image-task|image-v2)\.html$ /python-openstackclient/$1/cli/command-objects/image/v2/index.html
+redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/command-objects/(address-group|address-scope|default-security-group-rule|floating-ip-port-forwarding|floating-ip|ip-availability|local-ip-association|local-ip|network-agent|network-auto-allocated-topology|network-flavor-profile|network-flavor|network-l3-conntrack-helper|network-meter-rule|network-meter|network-qos-policy|network-qos-rule-type|network-qos-rule|network-rbac|network-segment|network-service-provider|network-trunk|network|network_segment_range|port|router-ndp-proxy|router|security-group-rule|security-group|subnet-pool|subnet)\.html$ /python-openstackclient/$1/cli/command-objects/network/v2/index.html
+redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/command-objects/(container|object-store-account|object)\.html$ /python-openstackclient/$1/cli/command-objects/object-store/v1/index.html
+redirectmatch 301 ^/python-openstackclient/([^/]+)/cli/command-objects/(block-storage-cleanup|block-storage-cluster|block-storage-log-level|block-storage-manage|block-storage-resource-filter|consistency-group-snapshot|consistency-group|volume-attachment|volume-backend|volume-backup|volume-group-snapshot|volume-group-type|volume-group|volume-host|volume-message|volume-qos|volume-service|volume-snapshot|volume-transfer-request|volume-type|volume)\.html$ /python-openstackclient/$1/cli/command-objects/volume/v3/index.html

doc/source/cli/_hidden/ec2-credentials.rst

@@ -8,4 +8,24 @@ Command List
    :glob:
    :maxdepth: 2
 
-   command-objects/*
+   command-objects/common/index
+   command-objects/compute/v2/index
+   command-objects/identity/v2/index
+   command-objects/identity/v3/index
+   command-objects/image/v1/index
+   command-objects/image/v2/index
+   command-objects/network/v2/index
+   command-objects/object-store/v1/index
+   command-objects/share/v2/index
+   command-objects/volume/v2/index
+   command-objects/volume/v3/index
+
+.. toctree::
+   :hidden:
+
+   command-objects/identity/index
+   command-objects/image/index
+   command-objects/network/index
+   command-objects/object-store/index
+   command-objects/share/index
+   command-objects/volume/index