Project factory additions, project module reuse implementation (#2899)

* add support for buckets

* add project-level interpolation for own SAs

* docs

* project reuse changes

* fix example

* tfdoc

* update check documentation tool

* fast tests

* blueprints

* typo

tools/tfdoc.py

@@ -169,16 +169,19 @@ def _parse(body, enum=VAR_ENUM, re=VAR_RE, template=VAR_TEMPLATE):
         item[context].append(data)
 
 
-def create_toc(readme):
+def create_toc(readme, skip=['contents']):
   'Create a Markdown table of contents a for README.'
   doc = marko.parse(readme)
   lines = []
   headings = [x for x in doc.children if x.get_type() == 'Heading']
+  skip = skip or []
   for h in headings[1:]:
     title = h.children[0].children
     slug = title.lower().strip()
     slug = re.sub(r'[^\w\s-]', '', slug)
     slug = re.sub(r'[-\s]+', '-', slug)
+    if slug in skip:
+      continue
     link = f'- [{title}](#{slug})'
     indent = '  ' * (h.level - 2)
     lines.append(f'{indent}{link}')
@@ -512,8 +515,9 @@ def render_toc(readme, toc):
 @click.option('--replace/--no-replace', default=True)
 @click.option('--show-extra/--no-show-extra', default=False)
 @click.option('--toc-only', is_flag=True, default=False)
+@click.option('--toc-skip', multiple=True, default=['contents'])
 def main(module_path=None, exclude_file=None, files=False, replace=True,
-         show_extra=True, toc_only=False):
+         show_extra=True, toc_only=False, toc_skip=['contents']):
   'Program entry point.'
   if toc_only and module_path.endswith('.md'):
     readme_path = module_path
@@ -523,7 +527,7 @@ def main(module_path=None, exclude_file=None, files=False, replace=True,
   if not toc_only:
     doc = create_tfref(module_path, files, show_extra, exclude_file, readme)
     readme = render_tfref(readme, doc.content)
-  toc = create_toc(readme)
+  toc = create_toc(readme, toc_skip)
   readme = render_toc(readme, toc)
   if replace:
     try: