Follow the new PTI for document build

- Follow new PTI for docs build
- Add sphinxcontrib.apidoc to replace pbr autodoc

REF:
https://governance.openstack.org/tc/reference/project-testing-interface.html
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html
http://lists.openstack.org/pipermail/openstack-dev/2018-March/128594.html

Change-Id: I76e8ec019ef30fdc2d34a25a99e849407f586459

2 files changed, 11 insertions, 6 deletions

diff --git a/doc/source/api_v1.rst b/doc/source/api_v1.rst
index eb29c28..f3dea2c 100644
--- a/doc/source/api_v1.rst
+++ b/doc/source/api_v1.rst
@@ -96,11 +96,7 @@ Refer to the modules themselves, for more details.
 ironicclient Modules
 ====================
 
-.. toctree::
-    :maxdepth: 1
-
-    modules <api/autoindex>
-
+* :ref:`modindex`
 
 .. _ironicclient.v1.node: api/ironicclient.v1.node.html#ironicclient.v1.node.Node
 .. _ironicclient.v1.client.Client: api/ironicclient.v1.client.html#ironicclient.v1.client.Client
diff --git a/doc/source/conf.py b/doc/source/conf.py
index 270cc79..3556454 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -2,12 +2,21 @@
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinx.ext.autodoc',
+extensions = ['sphinxcontrib.apidoc',
               'sphinx.ext.viewcode',
               'openstackdocstheme',
               'cliff.sphinxext',
               ]
 
+# sphinxcontrib.apidoc options
+apidoc_module_dir = '../../ironicclient'
+apidoc_output_dir = 'api'
+apidoc_excluded_paths = [
+    'tests/functional/*',
+    'tests']
+apidoc_separate_modules = True
+
+
 # openstackdocstheme options
 repository_name = 'openstack/python-ironicclient'
 bug_project = 'python-ironicclient'