sandialabs · dmdunla · Apr 16, 2025 · Jul 10, 2025 · Jul 10, 2025 · Jul 10, 2025
diff --git a/docs/source/_templates/autosummary/base.rst b/docs/source/_templates/autosummary/base.rst
@@ -0,0 +1,5 @@
+{{ objname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. auto{{ objtype }}:: {{ objname }}
diff --git a/docs/source/_templates/autosummary/class.rst b/docs/source/_templates/autosummary/class.rst
@@ -0,0 +1,30 @@
+{{ objname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :members:
+   :special-members:
+   :exclude-members: __dict__, __weakref__, __slots__, __init__, __deepcopy__, __hash__
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: Attributes
+   .. autosummary::
+      :toctree:
+   {% for item in attributes %}
+      {{ name }}.{{ item }}
+   {% endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block methods %}
+   {% if methods %}
+   .. rubric:: Methods
+   .. autosummary::
+      :toctree:
+   {% for item in methods %}
+      {{ name }}.{{ item }}
+   {% endfor %}
+   {% endif %}
+   {% endblock %}
diff --git a/docs/source/_templates/autosummary/module.rst b/docs/source/_templates/autosummary/module.rst
@@ -0,0 +1,23 @@
+{{ fullname | escape | underline }}
+
+.. rubric:: Description
+.. automodule:: {{ fullname }}
+.. currentmodule:: {{ fullname }}
+
+{% if classes %}
+.. rubric:: Classes
+.. autosummary::
+    :toctree:
+    {% for class in classes %}
+    {{ class }}
+    {% endfor %}
+{% endif %}
+
+{% if functions %}
+.. rubric:: Functions
+.. autosummary::
+    :toctree:
+    {% for function in functions %}
+    {{ function }}
+    {% endfor %}
+{% endif %}
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -52,10 +52,11 @@
     "sphinx.ext.mathjax",
     "sphinx.ext.viewcode",
     "sphinx.ext.napoleon",
+    "sphinx.ext.autosummary",
     "myst_nb",
 ]
 
-autodoc_preserve_defaults = True
+# autodoc_preserve_defaults = True
 
 myst_enable_extensions = [
     "amsmath",
@@ -197,6 +198,9 @@
 
 # -- Extension configuration -------------------------------------------------
 # Autodoc settings
-autoclass_content = "class"
+# autoclass_content = "both"
 autodoc_member_order = "bysource"
-autodoc_class_signature = "separated"
+autosummary_generate = True
+autosummary_generate_overwrite = False
+autosummary_ignore_module_all = False
+autosummary_imported_members = True
diff --git a/docs/source/functionality.rst b/docs/source/functionality.rst
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -71,11 +71,11 @@ This is relevant for indexing. In the future we hope to extend support for both.
 
    getting_started.rst
 
-Python API
+Python Reference
 ================
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 3
 
    reference.rst
 

diff --git a/docs/source/ktensor.rst b/docs/source/ktensor.rst
diff --git a/docs/source/pyttb_utils.rst b/docs/source/pyttb_utils.rst
diff --git a/docs/source/reference.rst b/docs/source/reference.rst
@@ -1,8 +1,20 @@
-Reference (:mod:`pyttb`)
-========================
+Reference (:class:`pyttb`)
+==========================
 
-.. toctree::
-    :maxdepth: 2
+.. rubric:: Description
+.. automodule:: pyttb
+.. currentmodule:: pyttb
 
-    tensor_classes.rst
-    algorithms.rst
+
+.. rubric:: Classes
+.. autosummary::
+    :toctree: generated
+
+    pyttb.tensor
+    pyttb.sptensor
+    pyttb.ktensor
+    pyttb.ttensor
+    pyttb.sumtensor
+    pyttb.tenmat
+    pyttb.sptenmat
+    pyttb.pyttb_utils
diff --git a/docs/source/sptenmat.rst b/docs/source/sptenmat.rst
diff --git a/docs/source/sptensor.rst b/docs/source/sptensor.rst
diff --git a/docs/source/sumtensor.rst b/docs/source/sumtensor.rst
diff --git a/docs/source/tenmat.rst b/docs/source/tenmat.rst
diff --git a/docs/source/tensor.rst b/docs/source/tensor.rst
diff --git a/docs/source/tensor_classes.rst b/docs/source/tensor_classes.rst
diff --git a/docs/source/ttensor.rst b/docs/source/ttensor.rst