Fix doc generation warnings and errors

When docs are generated with pbr command 'warnerrors = True'
there are many doc problems that are shown. This patch fixes
these problems.

Closes-Bug: #1557234
Change-Id: I05f2f96a582e44be28ab73e0bb80294facf902d5

doc/source/conf.py

@@ -44,7 +44,7 @@ pygments_style = 'sphinx'
 # Sphinx are currently 'default' and 'sphinxdoc'.
 # html_theme_path = ["."]
 # html_theme = '_theme'
-html_static_path = ['static']
+# html_static_path = ['static']
 
 # Output file base name for HTML help builder.
 htmlhelp_basename = '%sdoc' % project

doc/source/index.rst

@@ -10,8 +10,11 @@ glance_store Manual Pages
 .. toctree::
    :maxdepth: 1
 
+   Module Hierarchy <api/modules>
+
 * :ref:`modindex`
 
+
 Store Drivers
 =============
 
@@ -61,7 +64,7 @@ Release Notes
 
 * Dropped py26 support
 * Disable propagating BadStoreConfiguration
-* _1454695: Sync with global-requirements
+* 1454695_: Sync with global-requirements
 * Handle optional dependency in vmware store
 
 .. _1454695: https://bugs.launchpad.net/glance-store/+bug/1454695
@@ -69,10 +72,10 @@ Release Notes
 0.5.0
 -----
 
-* _1449639: Fix failure when creating an image which already exists in the RBD store
-* _1444663: Correctly instantiate Forbidden exception
-* _1428257: Do not raise an exception when a duplicate path on filesystem store is used. Instead emmit a warning
-* _1422699: Propagate BadStoreConfiguration to library user
+* 1449639_: Fix failure when creating an image which already exists in the RBD store
+* 1444663_: Correctly instantiate Forbidden exception
+* 1428257_: Do not raise an exception when a duplicate path on filesystem store is used. Instead emmit a warning
+* 1422699_: Propagate BadStoreConfiguration to library user
 * Initialize vmware session during store creation
 
 .. _1449639: https://bugs.launchpad.net/glance-store/+bug/1449639
@@ -84,9 +87,9 @@ Release Notes
 -----
 * Deprecate the gridfs store
 * Use oslo_config.cfg.ConfigOpts in glance_store
-* _1426767: Make dependency on boto entirely conditional
-* _1429785: Fix timeout during upload from slow resource
-* _1418396: Throw NotFound exception when template is gone
+* 1426767_: Make dependency on boto entirely conditional
+* 1429785_: Fix timeout during upload from slow resource
+* 1418396_: Throw NotFound exception when template is gone
 * Correct such logic in store.get() when chunk_size param provided
 
 .. _1426767: https://bugs.launchpad.net/glance-store/+bug/1426767
@@ -119,7 +122,7 @@ Release Notes
 * Convert httpretty tests to requests-mock
 
 0.1.11
--------
+------
 
 * 1402354_: Check VMware session before uploading image
 * Add capabilities to storage driver

setup.cfg

@@ -74,6 +74,7 @@ all_files = 1
 
 [pbr]
 autodoc_tree_index_modules = True
+warnerrors = True
 
 [upload_sphinx]
 upload-dir = doc/build/html