diff --git a/doc/source/index.rst b/doc/source/index.rst index 27256d4..73a8074 100644 --- a/doc/source/index.rst +++ b/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` diff --git a/setup.cfg b/setup.cfg index 8d2e5cc..3962ed4 100644 --- a/setup.cfg +++ b/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 diff --git a/specs/newton/approved/refstack-waiver.rst b/specs/newton/approved/refstack-waiver.rst index c0b26b7..015fab7 100644 --- a/specs/newton/approved/refstack-waiver.rst +++ b/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 diff --git a/tox.ini b/tox.ini index b07c13b..83683a6 100644 --- a/tox.ini +++ b/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