rearrange content using the new standard layout

Also turn on warning-is-error for the sphinx build.

Change-Id: I4a839924212fde7e6ae31a87ea8a0c6cf45313e9
Signed-off-by: Doug Hellmann <doug@doughellmann.com>

doc/source/contributing.rst

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

doc/source/contributor/index.rst

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

doc/source/index.rst

@@ -3,21 +3,19 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to designatedashboard's documentation!
+================================================
-========================================================
+ Welcome to designatedashboard's documentation!
-
+================================================
-Contents:
 
 .. toctree::
    :maxdepth: 2
 
    readme
-   installation
+   install/index
-   usage
+   user/index
-   contributing
+   contributor/index
 
-Indices and tables
+.. rubric:: Indices and tables
-==================
 
 * :ref:`genindex`
 * :ref:`search`

setup.cfg

@@ -26,6 +26,7 @@ packages =
 source-dir = doc/source
 build-dir = doc/build
 all_files = 1
+warning-is-error = 1
 
 [upload_sphinx]
 upload-dir = doc/build/html