Unification content of the index.rst file

In the index.rst file, sometime, we declare that name_of_file.rst,
sometime is name_of_file.

For example. the content of the barbican/doc/source/api/index.rst
is that:

"""
    ./reference/secrets
    ./reference/secret_types
    ./reference/secret_metadata
    ./reference/store_backends.rst
    ./reference/containers
    ./reference/acls
    ./reference/quotas
    ./reference/consumers
    ./reference/orders
"""
That is confusing, it should be like below:

"""
    ./reference/secrets.rst
    ./reference/secret_types.rst
    ./reference/secret_metadata.rst
    ./reference/store_backends.rst
    ./reference/containers.rst
    ./reference/acls.rst
    ./reference/quotas.rst
    ./reference/consumers.rst
    ./reference/orders.rst
"""

Change-Id: I54ca41bb27f59caaaddab977ef4a3cf7f66bb5f3
Closes-Bug: #1694180

doc/source/api/index.rst

@@ -14,12 +14,12 @@ API Reference
 .. toctree::
     :maxdepth: 1
 
-    ./reference/secrets
-    ./reference/secret_types
-    ./reference/secret_metadata
+    ./reference/secrets.rst
+    ./reference/secret_types.rst
+    ./reference/secret_metadata.rst
     ./reference/store_backends.rst
-    ./reference/containers
-    ./reference/acls
-    ./reference/quotas
-    ./reference/consumers
-    ./reference/orders
+    ./reference/containers.rst
+    ./reference/acls.rst
+    ./reference/quotas.rst
+    ./reference/consumers.rst
+    ./reference/orders.rst

doc/source/index.rst

@@ -17,7 +17,7 @@ API.
 .. toctree::
    :maxdepth: 1
 
-   api/index
+   api/index.rst
 
 Barbican for Developers
 =======================
@@ -33,22 +33,22 @@ development environment.
 .. toctree::
    :maxdepth: 1
 
-   setup/dev
-   setup/devstack
+   setup/dev.rst
+   setup/devstack.rst
 
 When you're ready to dive deeper in to barbican take a look at:
 
 .. toctree::
    :maxdepth: 1
 
-   contribute/getting_involved
-   contribute/architecture
-   contribute/structure
-   contribute/dataflow
-   contribute/dependencies
-   contribute/database_migrations
-   plugin/index
-   testing
+   contribute/getting_involved.rst
+   contribute/architecture.rst
+   contribute/structure.rst
+   contribute/dataflow.rst
+   contribute/dependencies.rst
+   contribute/database_migrations.rst
+   plugin/index.rst
+   testing.rst
 
 Barbican for Operators
 ======================
@@ -59,9 +59,9 @@ will probably want to read:
 .. toctree::
    :maxdepth: 1
 
-   setup/index
-   admin-guide-cloud/index
-   upgrade/index
+   setup/index.rst
+   admin-guide-cloud/index.rst
+   upgrade/index.rst
 
 This documentation is generated by the Sphinx toolkit and lives in the source
 tree.

doc/source/plugin/index.rst

@@ -69,5 +69,5 @@ Barbican, as well as configuration and deployment options.
 .. toctree::
    :maxdepth: 1
 
-   secret_store
-   crypto
+   secret_store.rst
+   crypto.rst

doc/source/setup/index.rst

@@ -4,11 +4,11 @@ Setting up Barbican
 .. toctree::
    :maxdepth: 1
 
-   dev
-   keystone
-   devstack
-   certificate
-   troubleshooting
-   noauth
-   audit
-   plugin_backends
+   dev.rst
+   keystone.rst
+   devstack.rst
+   certificate.rst
+   troubleshooting.rst
+   noauth.rst
+   audit.rst
+   plugin_backends.rst