rearrange existing documentation to fit the new standard layout

Change-Id: Iac95a337ac0a3ae8da1dd7c0a575c4d7b68fe632

CONTRIBUTING.rst

@@ -1,16 +1,13 @@
 If you would like to contribute to the development of OpenStack,
 you must follow the steps in this page:
-
-   http://docs.openstack.org/infra/manual/developers.html
+http://docs.openstack.org/infra/manual/developers.html
 
 Once those steps have been completed, changes to OpenStack
 should be submitted for review via the Gerrit tool, following
 the workflow documented at:
-
-   http://docs.openstack.org/infra/manual/developers.html#development-workflow
+http://docs.openstack.org/infra/manual/developers.html#development-workflow
 
 Pull requests submitted through GitHub will be ignored.
 
 Bugs should be filed on Launchpad, not GitHub:
-
-   https://bugs.launchpad.net/debtcollector
+https://bugs.launchpad.net/debtcollector

doc/source/contributor/index.rst

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

doc/source/history.rst

@@ -1 +0,0 @@
-.. include:: ../../ChangeLog

doc/source/index.rst

@@ -1,3 +1,4 @@
+=========================================
 Welcome to debtcollector's documentation!
 =========================================
 
@@ -11,27 +12,15 @@ collect your technical debt in a non-destructive manner.
     integration is it aims to be generally usable and useful in any
     project.
 
-Contents
-========
-
 .. toctree::
    :maxdepth: 2
 
-   installation
-   api
-   examples
-   contributing
+   install/index
+   user/index
+   reference/index
+   contributor/index
 
-Release Notes
-=============
-
-.. toctree::
-   :maxdepth: 1
-
-   history
-
-Indices and tables
-==================
+.. rubric:: Indices and tables
 
 * :ref:`genindex`
 * :ref:`modindex`

doc/source/reference/index.rst

@@ -1,6 +1,6 @@
-===
-API
-===
+=============
+API Reference
+=============
 
 
 The currently documented publicly exposed API's for usage in your project

doc/source/user/history.rst

@@ -0,0 +1 @@
+.. include:: ../../../ChangeLog

doc/source/user/index.rst

@@ -0,0 +1,14 @@
+===================
+Using debtcollector
+===================
+
+.. toctree::
+   :maxdepth: 2
+
+   usage
+
+.. history contains a lot of sections, toctree with maxdepth 1 is used.
+.. toctree::
+   :maxdepth: 1
+
+   history

releasenotes/source/index.rst

@@ -2,8 +2,8 @@
  debtcollector Release Notes
 =============================
 
- .. toctree::
-    :maxdepth: 1
+.. toctree::
+   :maxdepth: 1
 
-    unreleased
-    ocata
+   unreleased
+   ocata