Fix documentation tree

Fixed autogenerated sphinx documentation main tree
to include all approved specs.

Change-Id: Icb5cc6bf87a75929e9a683ac98ab512c69a945a7

doc/source/index.rst

@@ -1,20 +1,28 @@
+===========================================
 Welcome to refstack-client's documentation!
 ===========================================
 
-Contents:
------------
+---------------------
+About refstack-client
+---------------------
 
 .. toctree::
-   :maxdepth: 4
-   :glob:
+   :maxdepth: 2
 
    readme
 
-   specs/newton/approved/*
+-----------------
+Approved Features
+-----------------
 
-   specs/newton/implemented/*
+.. toctree::
+   :titlesonly:
+   :glob:
 
+   specs/*/approved/*
+
+------------------
 Indices and tables
-==================
+------------------
 
 * :ref:`search`

setup.cfg

@@ -30,3 +30,8 @@ setup-hooks =
 [entry_points]
 console_scripts =
     refstack-client = refstack_client.refstack_client:entry_point
+
+[build_sphinx]
+all_files = 1
+build-dir = doc/build
+source-dir = doc/source

specs/newton/approved/refstack-waiver.rst

@@ -1,7 +1,6 @@
-======================================================================
-Refstack-client implementation of Defcore waiver regarding additional
-properties on Nova API response
-======================================================================
+=============================================================
+Defcore waiver for additional properties on Nova API response
+=============================================================
 
 Launchpad blueprint: https://blueprints.launchpad.net/refstack/+spec/refstack-waiver
 

tox.ini

@@ -34,7 +34,7 @@ commands = coverage run \
            /bin/rm .coverage
 
 [testenv:docs]
-commands = python setup.py build_sphinx
+commands = python setup.py build_sphinx {posargs}
 
 [flake8]
 # E125 continuation line does not distinguish itself from next logical line