rearrange the existing docs to follow the new standard layout

Change-Id: Ia033a9243a55f4a7dfd70d5e0515d6d3372d6e08
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

@@ -6,10 +6,7 @@ Contents
 .. toctree::
    :maxdepth: 2
 
-   design
-   installation
-   usage
-   sphinxext
-   contributing
-   history
-   examples
+   user/index
+   install/index
+   contributor/index
+   releasenotes/index

doc/source/user/examples.rst

@@ -5,7 +5,7 @@
 Input file
 ==========
 
-.. literalinclude:: ../../examples/notes/add-complex-example-6b5927c246456896.yaml
+.. literalinclude:: ../../../examples/notes/add-complex-example-6b5927c246456896.yaml
    :caption: examples/notes/add-complex-example-6b5927c246456896.yaml
    :language: yaml
 

doc/source/user/index.rst

@@ -0,0 +1,10 @@
+=================
+ reno User Guide
+=================
+
+.. toctree::
+
+   design
+   usage
+   sphinxext
+   examples

doc/source/user/usage.rst

@@ -141,7 +141,7 @@ not needed for the bullet items in the other sections of the template.
 To escape the text of any section and *retain* the newlines, prefix
 the value with ``|``. For example:
 
-.. include:: ../../examples/notes/add-complex-example-6b5927c246456896.yaml
+.. include:: ../../../examples/notes/add-complex-example-6b5927c246456896.yaml
    :literal:
 
 See :doc:`examples` for the rendered version of the note.