Trying autoapi

Makefile

@@ -65,7 +65,7 @@ coverage: ## check code coverage quickly with the default Python
 docs: ## generate Sphinx HTML documentation, including API docs
 	rm -f docs/whisk.rst
 	rm -f docs/modules.rst
-	sphinx-apidoc -o docs/ whisk
+	# sphinx-apidoc -o docs/ whisk
 	$(MAKE) -C docs clean
 	$(MAKE) -C docs html
 	$(BROWSER) docs/_build/html/index.html

docs/Makefile

@@ -17,5 +17,4 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	sphinx-apidoc -o $(SOURCEDIR) ../$(SPHINXPROJ)
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/conf.py

@@ -31,7 +31,10 @@
 
 # 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', 'sphinx.ext.viewcode']
+extensions = ['sphinx.ext.autodoc', 'sphinx.ext.viewcode', 'autoapi.extension']
+
+autoapi_dirs = ['../whisk']
+autoapi_ignore = ['*/template/*']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

requirements_dev.txt

@@ -12,3 +12,4 @@ pytest==4.6.5
 pytest-runner==5.1
 check-manifest
 sphinx_rtd_theme
+sphinx-autoapi