switch to autoapi for docs generation (#1368)

Author: mr-c

Makefile

@@ -68,6 +68,10 @@ dist: dist/${MODULE}-$(VERSION).tar.gz
 dist/${MODULE}-$(VERSION).tar.gz: $(SOURCES)
 	./setup.py sdist bdist_wheel
 
+## docs	       : make the docs
+docs: FORCE
+	cd docs && $(MAKE) html
+
 ## clean       : clean up all temporary / machine-generated files
 clean: FORCE
 	rm -f ${MODILE}/*.pyc tests/*.pyc

docs/conf.py

@@ -30,6 +30,9 @@
 extensions = [
         "sphinx.ext.autodoc",
         "sphinx.ext.autosummary",
+        "sphinx.ext.inheritance_diagram",
+        "autoapi.extension",
+        "sphinx_autodoc_typehints",
         "sphinx_rtd_theme",
 ]
 
@@ -58,3 +61,14 @@
 from pkg_resources import get_distribution
 release = get_distribution('cwltool').version
 version = '.'.join(release.split('.')[:2])
+
+autoapi_dirs = ['../cwltool']
+autodoc_typehints = 'description'
+autoapi_keep_files = True
+autoapi_ignore = ['*migrations*', '*.pyi']
+autoapi_options = [ 'members', 'undoc-members', 'show-inheritance', 'show-inheritance-diagram', 'show-module-summary', 'imported-members', 'special-members' ]
+#sphinx-autodoc-typehints
+always_document_param_types = True
+# If False, do not add type info for undocumented parameters.
+# If True, add stub documentation for undocumented parameters to be able to add type info.
+