rearrange existing documentation to fit the new standard layout

README.rst was updated as the title of the doc top page was wrong.

Change-Id: I3821bdaa78a982c0a08fef584aec62a5549d5b8b

README.rst

@@ -1,12 +1,3 @@
-========================
-Team and repository tags
-========================
-
-.. image:: https://governance.openstack.org/badges/castellan.svg
-    :target: https://governance.openstack.org/reference/tags/index.html
-
-.. Change things from this point on
-
 =========
 Castellan
 =========
@@ -17,3 +8,9 @@ Generic Key Manager interface for OpenStack.
 * Documentation: https://docs.openstack.org/developer/castellan
 * Source: https://git.openstack.org/cgit/openstack/castellan
 * Bugs: https://bugs.launchpad.net/castellan
+
+Team and repository tags
+========================
+
+.. image:: https://governance.openstack.org/badges/castellan.svg
+    :target: https://governance.openstack.org/reference/tags/index.html

doc/source/contributing.rst

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

doc/source/contributor/contributing.rst

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

doc/source/contributor/index.rst

@@ -0,0 +1,9 @@
+====================
+Contributor Document
+====================
+
+.. toctree::
+   :maxdepth: 2
+
+   contributing
+   testing

doc/source/index.rst

@@ -3,19 +3,17 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to castellan's documentation!
-========================================================
+.. include:: ../../README.rst
 
-Contents:
+Contents
+========
 
 .. toctree::
    :maxdepth: 2
 
-   readme
-   installation
-   usage
-   testing
-   contributing
+   install/index
+   user/index
+   contributor/index
 
 Indices and tables
 ==================

doc/source/readme.rst

@@ -1 +0,0 @@
-.. include:: ../../README.rst