Fix 'bad' words in Boron docs
[docs.git] / docs / index.rst
index 1ecabbe62ebf325e286cde7981a7f015870e24e4..0ed5050db4b1d641bcb511a213cf13421529ec64 100644 (file)
@@ -6,18 +6,59 @@
 Welcome to the OpenDaylight Handbook!
 =====================================
 
-Contents:
+This handbook provides details on various aspects of OpenDaylight from the user
+guides to the developer guides and tries to act as a single point of contact
+for all documentation related articles in OpenDaylight. If you would like to
+contribute to the Handbook please refer to the :ref:`documentation-guide`.
+
+Content for OpenDaylight Users
+------------------------------
+
+The following content is intended for people who would like to deploy, use, or
+just learn more about OpenDaylight.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    getting-started-guide/index
+   user-guide/index
    opendaylight-with-openstack/index
-   submodules/releng/builder/docs/index
 
-Indices and tables
-==================
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+Content for OpenDaylight Developers
+-----------------------------------
+
+The Following content is intended for developers building applications or code
+on top of OpenDaylight, but who do not plan to modify OpenDaylight code
+itself.
+
+.. toctree::
+   :maxdepth: 1
+
+   developer-guide/index
+
+
+Content for OpenDaylight Contributors
+-------------------------------------
+
+The following content is intended for developers who either currently
+participate in the development of OpenDaylight or would like to start.
+
+.. toctree::
+   :maxdepth: 1
+
+   gerrit
+   submodules/releng/builder/docs/index
+   submodules/integration/test/docs/index
+   documentation
+   release-process/index
+   submodules/spectrometer/docs/index
+   javadoc
+
+.. Commenting the below out until we actually use it
+.. Indices and tables
+.. ==================
+..
+.. * :ref:`genindex`
+.. * :ref:`modindex`
+.. * :ref:`search`