Fix vmware_nsx documentation

Fix documentation warnings

Change-Id: Icf2c01c6b4814b69221de4ad432d092164205b28

CONTRIBUTING.rst

@@ -1,3 +1,7 @@
+=================
+Contributor Guide
+=================
+
 If you would like to contribute to the development of OpenStack,
 you must follow the steps documented at:
 

doc/source/devstack.rst

@@ -166,8 +166,8 @@ Enable trunk service and configure following flags in ``local.conf``::
     ENABLED_SERVICES+=,q-trunk
     Q_SERVICE_PLUGIN_CLASSES=trunk
 
-FWaaS (V1) Driver:
+FWaaS (V1) Driver
-~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~
 
 Add neutron-fwaas repo as an external repository and configure following flags in ``local.conf``::
 
@@ -243,8 +243,8 @@ Configure the service provider::
     [DEFAULT]
     api_extensions_path = $DEST/neutron-lbaas/neutron_lbaas/extensions
 
-FWaaS (V1) Driver:
+FWaaS (V1) Driver
-~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~
 
 Add neutron-fwaas repo as an external repository and configure following flags in ``local.conf``::
 

doc/source/history.rst

@@ -1 +0,0 @@
-.. include:: ../../ChangeLog

doc/source/index.rst

@@ -10,7 +10,9 @@ Contents:
    installation
    usage
    contributing
-   history
+   admin_util
+   devstack
+   housekeeper
 
 Code Documentation
 ==================
@@ -18,7 +20,6 @@ Code Documentation
 .. toctree::
    :maxdepth: 1
 
-   api/autoindex
 
 Indices and tables
 ==================

doc/source/readme.rst

@@ -1 +1 @@
-.. include:: ../README.rst
+.. include:: ../../README.rst

test-requirements.txt

@@ -6,6 +6,7 @@ hacking!=0.13.0,<0.14,>=0.12.0 # Apache-2.0
 coverage!=4.4,>=4.0 # Apache-2.0
 fixtures>=3.0.0 # Apache-2.0/BSD
 flake8-import-order==0.12 # LGPLv3
+sphinx!=1.6.6,!=1.6.7,>=1.6.5 # BSD
 mock>=2.0.0 # BSD
 
 psycopg2>=2.6.2 # LGPL/ZPL