Merge "Add top-level CLI reference page in docs"

doc/source/_extra/.htaccess

@@ -0,0 +1 @@
+redirectmatch 301 ^/designate/([^/]+)/admin/designate-manage.html$ /designate/$1/cli/designate-manage.html

doc/source/admin/index.rst

@@ -18,7 +18,6 @@ Contents:
    multiple-pools
    blacklists
    quotas
-   designate-manage
    policy
    config
    notifications

doc/source/cli/designate-manage.rst

@@ -1,4 +1,4 @@
-    .. _designate-manage:
+.. _designate-manage:
 
 ====================
 Designate Manage CLI

doc/source/cli/index.rst

@@ -0,0 +1,10 @@
+Command-Line Interface Reference
+================================
+
+Information on the commands available through Designate's Command Line
+Interface (CLI) can be found in this section.
+
+.. toctree::
+   :maxdepth: 1
+
+   designate-manage

doc/source/conf.py

@@ -149,6 +149,9 @@ html_theme_options = {}
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
 
+# Add any paths that contain "extra" files, such as .htaccess.
+html_extra_path = ['_extra']
+
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
 #html_last_updated_fmt = '%b %d, %Y'

doc/source/index.rst

@@ -18,6 +18,7 @@ Contents
     user/index
     admin/index
     configuration/index
+    cli/index
 
 For information on the Designate API, see the
 `API Reference <https://developer.openstack.org/api-ref/dns/>`_.