Try no page per method

.gitignore

@@ -78,7 +78,6 @@ docs/stubs
 docs/plot_directive
 docs/jupyter_execute/
 docs/migration_guides
-docs/_templates
 docs/source_images
 docs/.doctrees/
 stubs/

docs/_templates/class.rst

@@ -0,0 +1,31 @@
+{#
+   We show all the class's methods and attributes on the same page. By default, we document
+   all methods, including those defined by parent classes.
+-#}
+
+{{ objname | escape | underline }}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :no-members:
+   :show-inheritance:
+
+{% block attributes_summary %}
+  {% if attributes %}
+   .. rubric:: Attributes
+    {% for item in attributes %}
+   .. autoattribute:: {{ item }}
+    {%- endfor %}
+  {% endif %}
+{% endblock -%}
+
+{% block methods_summary %}
+  {% set wanted_methods = (methods | reject('==', '__init__') | list) %}
+  {% if wanted_methods %}
+   .. rubric:: Methods
+    {% for item in wanted_methods %}
+   .. automethod:: {{ item }}
+    {%- endfor %}
+  {% endif %}
+{% endblock %}

docs/_templates/class_no_inherited_members.rst

@@ -0,0 +1,28 @@
+{# This is identical to class.rst, except for the filtering in `set wanted_methods`. -#}
+
+{{ objname | escape | underline }}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :no-members:
+   :show-inheritance:
+
+{% block attributes_summary %}
+  {% if attributes %}
+   .. rubric:: Attributes
+    {% for item in attributes %}
+   .. autoattribute:: {{ item }}
+    {%- endfor %}
+  {% endif %}
+{% endblock -%}
+
+{% block methods_summary %}
+  {% set wanted_methods = (methods | reject('in', inherited_members) | reject('==', '__init__') | list) %}
+  {% if wanted_methods %}
+   .. rubric:: Methods
+    {% for item in wanted_methods %}
+   .. automethod:: {{ item }}
+    {%- endfor %}
+  {% endif %}
+{% endblock %}

docs/custom_extensions.py

@@ -21,7 +21,6 @@
 TERRA_DIRS = [
     "apidoc",
     "migration_guides",
-    "_templates",
     "source_images",
 ]
 

tox.ini

@@ -71,7 +71,6 @@ commands =
     {toxinidir}/docs/tutorials \
     {toxinidir}/docs/migration_guides \
     {toxinidir}/docs/source_images \
-    {toxinidir}/docs/_templates \
     {toxinidir}/docs/plot_directive \
     {toxinidir}/docs/jupyter_execute \
     {toxinidir}/docs/.doctrees