Follow the new PTI for document build

For compliance with the Project Testing Interface as described in:
https://governance.openstack.org/tc/reference/project-testing-interface.html
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html

Remove [build_sphinx] as described in:
http://lists.openstack.org/pipermail/openstack-dev/2018-March/128594.html

Change-Id: Ib1059403dccf7a58e8a8554c1298a601c2c067a2

doc/source/index.rst

@@ -27,7 +27,8 @@ Aodh API.
     __ https://docs.openstack.org/aodh/latest/
 
 
-Contents:
+Contents
+--------
 
 .. toctree::
    :maxdepth: 2
@@ -38,7 +39,7 @@ Contents:
    contributing
 
 Indices and tables
-==================
+------------------
 
 * :ref:`genindex`
 * :ref:`modindex`

setup.cfg

@@ -56,14 +56,6 @@ openstack.alarming.v2 =
     alarm-history show = aodhclient.v2.alarm_history_cli:CliAlarmHistoryShow
     alarming capabilities list = aodhclient.v2.capabilities_cli:CliCapabilitiesList
 
-[build_sphinx]
-source-dir = doc/source
-build-dir = doc/build
-all_files = 1
-
-[upload_sphinx]
-upload-dir = doc/build/html
-
 [compile_catalog]
 directory = aodhclient/locale
 domain = aodhclient

tox.ini

@@ -38,8 +38,9 @@ commands = sphinx-build -a -E -W -d releasenotes/build/doctrees -b html releasen
 [testenv:docs]
 deps = -r{toxinidir}/doc/requirements.txt
 commands =
-   rm -rf doc/source/ref
-   python setup.py build_sphinx
+   rm -rf doc/build
+   sphinx-build -b html doc/source doc/build/html
+whitelist_externals = rm
 
 [testenv:debug]
 commands = pifpaf --debug run aodh -- oslo_debug_helper {posargs}