Re-enable doc generation for contrib plugins

This re-enables doc generation for contrib plugins and removes legacy
code no longer needed because of stevedore.

Related-Bug: 1403897
Change-Id: Ia51cb7c8b0c375d2a430d45b9ece50eb67271788

doc/source/conf.py

@@ -47,10 +47,9 @@ for f in glob.glob(os.path.join(ENV_DIR, "*.yaml")):
 
 sys.path.insert(0, ROOT)
 sys.path.insert(0, BASE_DIR)
-sys.path = PLUGIN_DIRS + sys.path
 
 cfg.CONF.import_opt('plugin_dirs', 'heat.common.config')
-#cfg.CONF.set_override(name='plugin_dirs', override=PLUGIN_DIRS)
+cfg.CONF.set_override(name='plugin_dirs', override=PLUGIN_DIRS)
 
 cfg.CONF.import_opt('environment_dir', 'heat.common.config')
 cfg.CONF.set_override(name='environment_dir', override=TEMP_ENV_DIR)
@@ -61,17 +60,6 @@ os.environ['DJANGO_SETTINGS_MODULE'] = 'openstack_dashboard.settings'
 
 def write_autodoc_index():
 
-    def get_contrib_sources():
-        module_dirs = glob.glob(os.path.join(CONTRIB_DIR, '*'))
-        module_names = map(os.path.basename, module_dirs)
-
-        return dict(
-            ('contrib/%s' % module_name,
-             {'module': module_name,
-              'path': os.path.join(CONTRIB_DIR, module_name)}
-             )
-            for module_name in module_names)
-
     def find_autodoc_modules(module_name, sourcedir):
         """Return a list of modules in the SOURCE directory."""
         modlist = []
@@ -93,9 +81,7 @@ def write_autodoc_index():
         return modlist
 
     RSTDIR = os.path.abspath(os.path.join(BASE_DIR, "sourcecode"))
-    SRCS = {'heat': {'module': 'heat',
-                     'path': ROOT}}
-    SRCS.update(get_contrib_sources())
+    SOURCES = {'heat': {'module': 'heat', 'path': ROOT}}
 
     EXCLUDED_MODULES = ('heat.testing',
                         'heat.cmd',
@@ -120,7 +106,7 @@ def write_autodoc_index():
     INDEXOUT.write("Source Code Index\n")
     INDEXOUT.write("=================\n")
 
-    for title, info in SRCS.items():
+    for title, info in SOURCES.items():
         path = info['path']
         modulename = info['module']
         sys.stdout.write("Generating source documentation for %s\n" %

doc/source/ext/resources.py

@@ -17,7 +17,7 @@ import itertools
 from docutils import core
 from docutils import nodes
 import pydoc
-from sphinx.util.compat import Directive
+from sphinx.util import compat
 
 from heat.common.i18n import _
 from heat.engine import attributes
@@ -38,7 +38,7 @@ class resourcepages(nodes.General, nodes.Element):
     pass
 
 
-class ResourcePages(Directive):
+class ResourcePages(compat.Directive):
     has_content = False
     required_arguments = 0
     optional_arguments = 1

doc/source/template_guide/contrib.rst

@@ -56,4 +56,4 @@ find more information in the `NOVA_FLAVOR_README
 <https://github.com/openstack/heat/blob/master/contrib/nova_flavor
 /README.md>`_.
 
-.. resourcepages:: NovaFlavor::
+.. resourcepages:: OS::Nova::Flavor