DOC Restructure API documentation

.gitignore

@@ -40,6 +40,14 @@ junit-*.xml
 docs/source/*.model
 docs/source/*.pkl
 docs/source/*.tl
+docs/source/*.joblib
+
+## autosummary-generated API reference stubs
+docs/source/api/generated/
+
+## Sphinx build output
+docs/build/
+docs/_html/
 
 ## eclipse
 .project

docs/source/FIL.rst

@@ -138,7 +138,7 @@ FIL is ideal for many scenarios:
 API Reference
 =============
 
-See the :doc:`API reference <api>` for the API documentation.
+See the :doc:`API reference <api/index>` for the API documentation.
 
 Migration Guide
 ===============

docs/source/_templates/autosummary/base.rst

@@ -0,0 +1,26 @@
+{{ objname | escape | underline(line="=") }}
+
+{% if objtype == "module" -%}
+
+.. automodule:: {{ fullname }}
+
+{%- elif objtype == "function" -%}
+
+.. currentmodule:: {{ module }}
+
+.. autofunction:: {{ objname }}
+
+{%- elif objtype == "class" -%}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :members:
+
+{%- else -%}
+
+.. currentmodule:: {{ module }}
+
+.. auto{{ objtype }}:: {{ objname }}
+
+{%- endif -%}