rearrange the existing docs into the new standard layout

Change-Id: Ic8e3479b46e893bb5351cad59ade1115a007afd8

doc/source/cli/index.rst

@@ -0,0 +1,10 @@
+==================
+User Documentation
+==================
+
+.. toctree::
+   :maxdepth: 2
+
+   cli_usage
+   authentication
+   usage

doc/source/contributing.rst

@@ -1,4 +0,0 @@
-============
-Contributing
-============
-.. include:: ../../CONTRIBUTING.rst

doc/source/contributor/contributing.rst

@@ -0,0 +1,5 @@
+============
+Contributing
+============
+
+.. include:: ../../../CONTRIBUTING.rst

doc/source/contributor/index.rst

@@ -0,0 +1,10 @@
+=========================
+Contributor Documentation
+=========================
+
+.. toctree::
+   :maxdepth: 2
+
+   contributing.rst
+   testing.rst
+

doc/source/index.rst

@@ -1,8 +1,3 @@
-.. python-barbicanclient documentation master file, created by
-   sphinx-quickstart on Tue Jul  9 22:26:36 2013.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
 Python bindings to the OpenStack Key Management API (Barbican)
 ==============================================================
 
@@ -15,16 +10,13 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
-   installation
-   authentication
-   usage
-   cli_usage
-   reference
-   contributing
-   testing
+   install/index
+   cli/index
+   contributor/index
+   reference/index
 
-Indices and tables
-==================
+
+.. rubric:: Indices and tables
 
 * :ref:`genindex`
 * :ref:`modindex`