[no ci] docs: avoid explicitly listing modules

Author: vpratz

docsrc/source/_templates/custom-module-template.rst

@@ -1,4 +1,13 @@
+{% if objname == 'bayesflow' %}
+API Reference
+=============
+
+This is the reference for the public API. For a more guided introduction,
+please refer to the :doc:`Examples <../examples>` section.
+
+{% else %}
 {{ objname | escape | underline}}
+{% endif %}
 
 .. automodule:: {{ fullname }}
   :member-order: alphabetical

docsrc/source/api/bayesflow.rst

@@ -1,26 +1,12 @@
 API Reference
 =============
 
-This is the reference for the public API. For a more guided introduction,
-please refer to the :doc:`Examples <../examples>` section.
+This page will be overridden by the autosummary call for bayesflow.
+To modify the actual output, refer to _templates/custom-module-template.rst.
 
 .. autosummary::
     :toctree: .
     :template: custom-module-template.rst
     :recursive:
 
-    bayesflow.adapters
-    bayesflow.approximators
-    bayesflow.benchmarks
-    bayesflow.datasets
-    bayesflow.diagnostics
-    bayesflow.distributions
-    bayesflow.experimental
-    bayesflow.links
-    bayesflow.metrics
-    bayesflow.networks
-    bayesflow.simulators
-    bayesflow.scores
-    bayesflow.types
-    bayesflow.utils
-    bayesflow.workflows
+    bayesflow