rearrange existing documentation to fit the new standard layout

Change-Id: Ie4bdcc2034d0648a078e17b327df99f652887857

doc/source/history.rst

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

doc/source/index.rst

@@ -12,22 +12,9 @@ reasons (for example in isolating cross-project performance issues).
 .. toctree::
    :maxdepth: 2
 
-   background
+   user/index
-   api
-   integration
-   collectors
-   similar_projects
 
-Release Notes
+.. rubric:: Indices and tables
-=============
-
-.. toctree::
-   :maxdepth: 1
-
-   history
-
-Indices and tables
-==================
 
 * :ref:`genindex`
 * :ref:`modindex`

doc/source/user/history.rst

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

doc/source/user/index.rst

@@ -0,0 +1,27 @@
+================
+Using OSProfiler
+================
+
+OSProfiler provides a tiny but powerful library that is used by
+most (soon to be all) OpenStack projects and their python clients. It
+provides functionality to generate 1 trace per request, that goes
+through all involved services. This trace can then be extracted and used
+to build a tree of calls which can be quite handy for a variety of
+reasons (for example in isolating cross-project performance issues).
+
+.. toctree::
+   :maxdepth: 2
+
+   background
+   api
+   integration
+   collectors
+   similar_projects
+
+Release Notes
+=============
+
+.. toctree::
+   :maxdepth: 1
+
+   history