Add header and reorganize user_guide

Author: Pierre-Sassoulas

doc/index.rst

@@ -6,10 +6,46 @@
    :hidden:
 
    tutorial
-   user_guide/index.rst
-   development_guide/index.rst
+
+.. toctree::
+   :caption: User Guide
+   :titlesonly:
+   :hidden:
+
+   user_guide/installation/index
+   user_guide/run
+   user_guide/output
+   user_guide/messages/index
+   user_guide/configuration/index
+
+
+.. toctree::
+   :caption: Developer Guide
+   :maxdepth: 2
+   :titlesonly:
+   :hidden:
+
+   development_guide/index
+
+.. toctree::
+   :caption: Additional tools
+   :titlesonly:
+   :hidden:
+
    pyreverse
    symilar
+
+.. toctree::
+   :caption: Support
+   :titlesonly:
+   :hidden:
+
    faq
    contact
+
+.. toctree::
+   :caption: Changelog
+   :titlesonly:
+   :hidden:
+
    whatsnew/index.rst

doc/user_guide/index.rst

@@ -1,8 +1,5 @@
 .. _installation:
 
-Installation
-============
-
 Command line
 ------------
 

doc/user_guide/badge.rst renamed to doc/user_guide/installation/badge.rst

@@ -0,0 +1,19 @@
+Installation
+============
+
+Pylint can be installed:
+
+- As a command line tool
+- Integrated in your editor/ide
+- As a pre-commit hook
+
+.. toctree::
+   :caption: Installing pylint
+   :maxdepth: 2
+   :titlesonly:
+   :hidden:
+
+   command_line_installation.rst
+   ide_integration/index
+   pre-commit-integration.rst
+   badge