blueprint man-support and fix documentation build

bug 995283

Changes after initial comments

Removed spaces

Updates after comments

Remove white spaces

Fix text and remove empty files

Remove config.py

Updated to be similar to the keystone page

Updated afetr comments

Change-Id: If9240114ae31d7120c708cdcf883e8fe4c7d2bb2

doc/source/index.rst

@@ -14,13 +14,41 @@
       License for the specific language governing permissions and limitations
       under the License.
 
-Quantum Documentation
-======================================
+Welcome to Quantum's developer documentation!
+=============================================
 
-Contents
-========
+Quantum is an OpenStack project to provide "network connectivity as a service"
+between interface devices (e.g., vNICs) managed by other Openstack services
+(e.g., nova). It implements the `Quantum API Guide`_.
+
+.. _`Quantum API Guide`: http://docs.openstack.org/incubation/openstack-network/developer/quantum-api-1.0/content/
+
+This document describes Quantum for contributors of the project, and assumes
+that you are already familiar with Quantum from an `end-user perspective`_.
+
+.. _`end-user perspective`: http://docs.openstack.org/trunk/openstack-network/admin/content/index.html
+
+This documentation is generated by the Sphinx toolkit and lives in the source
+tree.  Additional documentation on Quantum and other components of OpenStack
+can be found on the `OpenStack wiki`_. The `Quantum Development wiki`_ is a very good
+place to start.
+
+.. _`OpenStack wiki`: http://wiki.openstack.org
+.. _`Quantum Development wiki`: http://wiki.openstack.org/QuantumDevelopment
+
+Enjoy!
+
+Development Documents
+=====================
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   api_index
+   devref/index
+
+Man Pages
+---------
+
+.. toctree::
+
+    man/quantum-server