rearrange existing documentation to fit the new standard layout3.27.0

Change-Id: I0727caae202b385d740b006fd957b990e308c6d7

26 files changed, 49 insertions, 50 deletions

diff --git a/doc/source/contributing.rst b/doc/source/contributing.rst
deleted file mode 100644
index 2ca75d1..0000000
--- a/doc/source/contributing.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-==============
- Contributing
-==============
-
-.. include:: ../../CONTRIBUTING.rst
diff --git a/doc/source/contributor/index.rst b/doc/source/contributor/index.rst
new file mode 100644
index 0000000..3d4ceb4
--- /dev/null
+++ b/doc/source/contributor/index.rst
@@ -0,0 +1,5 @@
+============
+Contributing
+============
+
+.. include:: ../../../CONTRIBUTING.rst
diff --git a/doc/source/history.rst b/doc/source/history.rst
deleted file mode 100644
index 69ed4fe..0000000
--- a/doc/source/history.rst
+++ /dev/null
@@ -1 +0,0 @@
-.. include:: ../../ChangeLog
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 9b445c4..9cd2faf 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -8,51 +8,12 @@ such as encoding, exception handling, string manipulation, and time handling.
 .. toctree::
    :maxdepth: 1
 
-   installation
-   usage
-   contributing
+   install/index
+   user/index
+   reference/index
+   contributor/index
 
-API Documentation
-=================
-
-.. toctree::
-   :maxdepth: 2
-
-   api/dictutils
-   api/encodeutils
-   api/eventletutils
-   api/excutils
-   api/fileutils
-   api/fixture
-   api/importutils
-   api/netutils
-   api/reflection
-   api/secretutils
-   api/specs_matcher
-   api/strutils
-   api/timeutils
-   api/units
-   api/uuidutils
-   api/versionutils
-
-Examples
-========
-
-.. toctree::
-   :maxdepth: 2
-
-   examples/timeutils
-
-Release Notes
-=============
-
-.. toctree::
-   :maxdepth: 1
-
-   history
-
-Indices and tables
-==================
+.. rubric:: Indices and tables
 
 * :ref:`genindex`
 * :ref:`modindex`
diff --git a/doc/source/installation.rst b/doc/source/install/index.rst
index 688d549..688d549 100644
--- a/doc/source/installation.rst
+++ b/doc/source/install/index.rst
diff --git a/doc/source/api/dictutils.rst b/doc/source/reference/dictutils.rst
index 00fb39d..00fb39d 100644
--- a/doc/source/api/dictutils.rst
+++ b/doc/source/reference/dictutils.rst
diff --git a/doc/source/api/encodeutils.rst b/doc/source/reference/encodeutils.rst
index 35f339c..35f339c 100644
--- a/doc/source/api/encodeutils.rst
+++ b/doc/source/reference/encodeutils.rst
diff --git a/doc/source/api/eventletutils.rst b/doc/source/reference/eventletutils.rst
index 5e7a39a..5e7a39a 100644
--- a/doc/source/api/eventletutils.rst
+++ b/doc/source/reference/eventletutils.rst
diff --git a/doc/source/api/excutils.rst b/doc/source/reference/excutils.rst
index f5a67a0..f5a67a0 100644
--- a/doc/source/api/excutils.rst
+++ b/doc/source/reference/excutils.rst
diff --git a/doc/source/api/fileutils.rst b/doc/source/reference/fileutils.rst
index 575bedf..575bedf 100644
--- a/doc/source/api/fileutils.rst
+++ b/doc/source/reference/fileutils.rst
diff --git a/doc/source/api/fixture.rst b/doc/source/reference/fixture.rst
index d8205ed..d8205ed 100644
--- a/doc/source/api/fixture.rst
+++ b/doc/source/reference/fixture.rst
diff --git a/doc/source/api/importutils.rst b/doc/source/reference/importutils.rst
index a8f7558..a8f7558 100644
--- a/doc/source/api/importutils.rst
+++ b/doc/source/reference/importutils.rst
diff --git a/doc/source/reference/index.rst b/doc/source/reference/index.rst
new file mode 100644
index 0000000..1fcbb1e
--- /dev/null
+++ b/doc/source/reference/index.rst
@@ -0,0 +1,23 @@
+=============
+API Reference
+=============
+
+.. toctree::
+   :maxdepth: 2
+
+   dictutils
+   encodeutils
+   eventletutils
+   excutils
+   fileutils
+   fixture
+   importutils
+   netutils
+   reflection
+   secretutils
+   specs_matcher
+   strutils
+   timeutils
+   units
+   uuidutils
+   versionutils
diff --git a/doc/source/api/netutils.rst b/doc/source/reference/netutils.rst
index 0fa3156..0fa3156 100644
--- a/doc/source/api/netutils.rst
+++ b/doc/source/reference/netutils.rst
diff --git a/doc/source/api/reflection.rst b/doc/source/reference/reflection.rst
index fc11d2b..fc11d2b 100644
--- a/doc/source/api/reflection.rst
+++ b/doc/source/reference/reflection.rst
diff --git a/doc/source/api/secretutils.rst b/doc/source/reference/secretutils.rst
index 3e9f943..3e9f943 100644
--- a/doc/source/api/secretutils.rst
+++ b/doc/source/reference/secretutils.rst
diff --git a/doc/source/api/specs_matcher.rst b/doc/source/reference/specs_matcher.rst
index 216eefd..216eefd 100644
--- a/doc/source/api/specs_matcher.rst
+++ b/doc/source/reference/specs_matcher.rst
diff --git a/doc/source/api/strutils.rst b/doc/source/reference/strutils.rst
index fe8dabf..fe8dabf 100644
--- a/doc/source/api/strutils.rst
+++ b/doc/source/reference/strutils.rst
diff --git a/doc/source/api/timeutils.rst b/doc/source/reference/timeutils.rst
index 0b5c72b..0b5c72b 100644
--- a/doc/source/api/timeutils.rst
+++ b/doc/source/reference/timeutils.rst
diff --git a/doc/source/api/units.rst b/doc/source/reference/units.rst
index 5a09d3b..5a09d3b 100644
--- a/doc/source/api/units.rst
+++ b/doc/source/reference/units.rst
diff --git a/doc/source/api/uuidutils.rst b/doc/source/reference/uuidutils.rst
index f1d03e9..f1d03e9 100644
--- a/doc/source/api/uuidutils.rst
+++ b/doc/source/reference/uuidutils.rst
diff --git a/doc/source/api/versionutils.rst b/doc/source/reference/versionutils.rst
index f75e726..f75e726 100644
--- a/doc/source/api/versionutils.rst
+++ b/doc/source/reference/versionutils.rst
diff --git a/doc/source/user/history.rst b/doc/source/user/history.rst
new file mode 100644
index 0000000..f69be70
--- /dev/null
+++ b/doc/source/user/history.rst
@@ -0,0 +1 @@
+.. include:: ../../../ChangeLog
diff --git a/doc/source/user/index.rst b/doc/source/user/index.rst
new file mode 100644
index 0000000..c31b8e4
--- /dev/null
+++ b/doc/source/user/index.rst
@@ -0,0 +1,15 @@
+==================
+Using oslo.service
+==================
+
+.. toctree::
+   :maxdepth: 2
+
+   usage
+   timeutils
+
+.. history contains a lot of sections, toctree with maxdepth 1 is used.
+.. toctree::
+   :maxdepth: 1
+
+   history
diff --git a/doc/source/examples/timeutils.rst b/doc/source/user/timeutils.rst
index eeecb50..eeecb50 100644
--- a/doc/source/examples/timeutils.rst
+++ b/doc/source/user/timeutils.rst
diff --git a/doc/source/usage.rst b/doc/source/user/usage.rst
index 88ee1ad..88ee1ad 100644
--- a/doc/source/usage.rst
+++ b/doc/source/user/usage.rst