Documentation Formatting

sudorandom · sudorandom · commit 10e7734a8ece · 2013-04-06T11:16:06.000-05:00
diff --git a/docs/api/managers.rst b/docs/api/managers.rst
@@ -0,0 +1,18 @@
+.. _managers:
+
+Managers
+--------
+::
+
+	>>> from SoftLayer.CCI import CCIManager
+	>>> cci = CCIManager(client)
+	>>> cci.list_instances()
+	[...]
+
+Managers mask out a lot of the complexities of using the API into classes that provide a simpler interface to various services.
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   managers/*
diff --git a/docs/index.rst b/docs/index.rst
@@ -1,10 +1,18 @@
 .. SoftLayer API Python Client documentation
 
-SoftLayer API Python Client
-===========================
+SoftLayer API Python Client |version|
+========================================
 This is the documentation to SoftLayer's Python API Bindings. These bindings use SoftLayer's `XML-RPC interface <http://sldn.softlayer.com/article/XML-RPC>`_ in order to manage SoftLayer services.
 
-Release v\ |version|. (:ref:`Installation <install>`)
+.. toctree::
+   :maxdepth: 2
+
+   install
+   SoftLayer API Documentation <http://sldn.softlayer.com/reference/softlayerapi>
+   Source on Github <https://github.com/softlayer/softlayer-api-python-client>
+   SoftLayer Developer Network <http://sldn.softlayer.com/>
+   Twitter <https://twitter.com/SoftLayerDevs>
+
 
 API Documentation
 -----------------
@@ -19,26 +27,8 @@ API Documentation
 .. toctree::
    :maxdepth: 2
 
-   install
    api/client
-
-
-Managers
---------
-::
-
-	>>> from SoftLayer.CCI import CCIManager
-	>>> cci = CCIManager(client)
-	>>> cci.list_instances()
-	[...]
-
-Managers mask out a lot of the complexities of using the API into classes that provide a simpler interface to various services.
-
-.. toctree::
-   :maxdepth: 1
-   :glob:
-
-   api/managers/*
+   api/managers
 
 
 Command-Line Interface
@@ -58,6 +48,7 @@ Command-Line Interface
    cli
    cli/dev
 
+
 Indices and tables
 ==================
 
diff --git a/docs/install.rst b/docs/install.rst
@@ -2,6 +2,10 @@
 
 Installation
 ============
+
+Using Pip
+---------
+
 Install via pip: ::
 
 	$ pip install softlayer
@@ -13,9 +17,8 @@ Install from source gia pip (requires git): ::
 The most up to date version of this library can be found on the SoftLayer GitHub public repositories: http://github.com/softlayer. Please post to the SoftLayer forums http://forums.softlayer.com/ or open a support ticket in the SoftLayer customer portal if you have any questions regarding use of this library.
 
 
-
-Get the Code
-------------
+From Source
+-----------
 
 The project is developed on GitHub, at `github.com/softlayer/softlayer-api-python-client <https://github.com/softlayer/softlayer-api-python-client>`_.
 
