commit 30b20b6e048aa0879e2116d17542cde8949219f4
author Vishakha Agarwal <agarwalvishakha18@gmail.com> Fri Sep 27 14:37:56 2019 +0530
committer Vishakha Agarwal <agarwalvishakha18@gmail.com> Wed Oct 09 14:37:23 2019 +0530
tree 592de655fc60fd33b6cd53e4b04178d3562f0a48
parent 806103f188cd9a56f1b2b81d86a8d2413cffff5d

Follow the PTI for docs

Use sphinx-build instead of the pbr sphinx extention for building docs
as instructed by the PTI[1].

It fixes the header formatting for the index page, as the headers weren't
rendering at all.

[1] https://governance.openstack.org/tc/reference/pti/python.html

Change-Id: Ibac2b45ecfab4a7e575d097ecb9fc2c5e57b81cf

doc/source/index.rst

diff --git a/doc/source/index.rst b/doc/source/index.rst
index 80d2267..7807170 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -6,7 +6,8 @@
 Welcome to openstack's documentation!
 ========================================================
 
-Contents:
+Contents
+--------
 
 .. toctree::
    :maxdepth: 2
@@ -17,7 +18,7 @@
    contributing
 
 Indices and tables
-==================
+-------------------
 
 * :ref:`genindex`
 * :ref:`modindex`