From 85c1ce13ab8223b178ad6c29be9beb30102b3293 Mon Sep 17 00:00:00 2001
From: Rossen Georgiev <rossen@rgp.io>
Date: Mon, 23 May 2016 09:51:42 +0100
Subject: [PATCH] docs: split intro sections to seperate file

This way section will show in the side menu
---
 docs/index.rst | 57 +++++++-------------------------------------------
 docs/intro.rst | 40 +++++++++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+), 49 deletions(-)
 create mode 100644 docs/intro.rst

diff --git a/docs/index.rst b/docs/index.rst
index b04e303..be44dc7 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,47 +1,13 @@
-:tocdepth: 10
+.. include:: intro.rst
 
-.. include:: global.rst
-
-``steam`` module documentation
-******************************
-
-|pypi| |license|
-
-A python module for interacting with various parts of Steam_.
-
-Supports Python ``2.7+`` and ``3.4+``.
-
-Main features:
-
-* :doc:`SteamID <api/steam.steamid>` - convert between the various ID representations with ease
-* :doc:`WebAPI <api/steam.webapi>` - simple API for Steam's Web API with automatic population of interfaces
-* :doc:`WebAuth <api/steam.webauth>` - authentication for access to ``store.steampowered.com`` and ``steamcommunity.com``
-* :doc:`SteamClient <api/steam.client>` - communication with the steam network based on ``gevent``.
-
-Checkout the :doc:`user_guide` for examples, or the :doc:`api/index` for details.
-
-For questions, issues, or general curiosity, visit the repo at `https://github.com/ValvePython/steam <https://github.com/ValvePython/steam>`_.
-
-Installing
-==========
-
-By default the ``steam`` package doesn't install all dependencies.
-Add ``[client]`` extra if you are going to use :class:`SteamClient <steam.client.SteamClient>`.
-
-Install latest version from PYPI::
-
-    pip install -U steam
-    pip install -U steam[client]
-
-Install the current dev version from ``github``::
-
-    pip install git+https://github.com/ValvePython/steam
-    pip install git+https://github.com/ValvePython/steam#egg=steam[client]
+.. toctree::
+    :maxdepth: 10
+    :hidden:
 
-For extras syntax in ``requirements.txt`` see `pip docs <https://pip.pypa.io/en/stable/reference/pip_install/#requirement-specifiers>`_::
+    intro
 
-Contents
-========
+Table of Contents
+-----------------
 
 .. toctree::
     :maxdepth: 3
@@ -49,14 +15,7 @@ Contents
     user_guide
 
 .. toctree::
-    :maxdepth: 5
+    :maxdepth: 10
 
     api/index
 
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
-
diff --git a/docs/intro.rst b/docs/intro.rst
new file mode 100644
index 0000000..ec6dfde
--- /dev/null
+++ b/docs/intro.rst
@@ -0,0 +1,40 @@
+.. include:: global.rst
+
+Intro
+=====
+
+|pypi| |license|
+
+A python module for interacting with various parts of Steam_.
+
+Supports Python ``2.7+`` and ``3.4+``.
+
+Main features
+=============
+
+* :doc:`SteamID <api/steam.steamid>` - convert between the various ID representations with ease
+* :doc:`WebAPI <api/steam.webapi>` - simple API for Steam's Web API with automatic population of interfaces
+* :doc:`WebAuth <api/steam.webauth>` - authentication for access to ``store.steampowered.com`` and ``steamcommunity.com``
+* :doc:`SteamClient <api/steam.client>` - communication with the steam network based on ``gevent``.
+
+Checkout the :doc:`user_guide` for examples, or the :doc:`api/index` for details.
+
+For questions, issues, or general curiosity, visit the repo at `https://github.com/ValvePython/steam <https://github.com/ValvePython/steam>`_.
+
+Installation
+============
+
+By default the ``steam`` package doesn't install all dependencies.
+Add ``[client]`` extra if you are going to use :class:`SteamClient <steam.client.SteamClient>`.
+
+Install latest version from PYPI::
+
+    pip install -U steam
+    pip install -U steam[client]
+
+Install the current dev version from ``github``::
+
+    pip install git+https://github.com/ValvePython/steam
+    pip install git+https://github.com/ValvePython/steam#egg=steam[client]
+
+For extras syntax in ``requirements.txt`` see `pip docs <https://pip.pypa.io/en/stable/reference/pip_install/#requirement-specifiers>`_