Documentation fixes / improvements

docs/_templates/autosummary/class.rst

@@ -8,52 +8,52 @@
 
 {% block attributes %}
 {% if attributes %}
-Attributes table
-~~~~~~~~~~~~~~~~
+    Attributes table
+    ~~~~~~~~~~~~~~~~
 
-.. autosummary::
-{% for item in attributes %}
-    ~{{ name }}.{{ item }}
-{%- endfor %}
-{% endif %}
-{% endblock %}
+    .. autosummary::
+    {% for item in attributes %}
+        ~{{ name }}.{{ item }}
+    {%- endfor %}
+    {% endif %}
+    {% endblock %}
 
 {% block methods %}
 {% if methods %}
-Methods table
-~~~~~~~~~~~~~
-
-.. autosummary::
-{% for item in methods %}
-    {%- if item != '__init__' %}
-    ~{{ name }}.{{ item }}
-    {%- endif -%}
-{%- endfor %}
-{% endif %}
-{% endblock %}
+    Methods table
+    ~~~~~~~~~~~~~
+
+    .. autosummary::
+    {% for item in methods %}
+        {%- if item != '__init__' %}
+        ~{{ name }}.{{ item }}
+        {%- endif -%}
+    {%- endfor %}
+    {% endif %}
+    {% endblock %}
 
 {% block attributes_documentation %}
 {% if attributes %}
-Attributes
-~~~~~~~~~~
+    Attributes
+    ~~~~~~~~~~
 
 {% for item in attributes %}
 
-.. autoattribute:: {{ [objname, item] | join(".") }}
+    .. autoattribute:: {{ [objname, item] | join(".") }}
 {%- endfor %}
 
 {% endif %}
 {% endblock %}
 
 {% block methods_documentation %}
 {% if methods %}
-Methods
-~~~~~~~
+    Methods
+    ~~~~~~~
 
 {% for item in methods %}
 {%- if item != '__init__' %}
 
-.. automethod:: {{ [objname, item] | join(".") }}
+    .. automethod:: {{ [objname, item] | join(".") }}
 {%- endif -%}
 {%- endfor %}
 

docs/api.md

@@ -1,22 +1,12 @@
 # API Reference
 
-```{contents}
-:depth: 3
-:local:
-```
-
-```{toctree}
-:maxdepth: 10
-```
-
 ```{eval-rst}
-.. currentmodule:: mudata
+.. module:: mudata
 ```
 
 ## Multimodal omics
 
 ```{eval-rst}
-.. module::mudata
 .. autosummary::
    :toctree: generated
 
@@ -26,7 +16,7 @@
 ## Input/Output
 
 ```{eval-rst}
-.. module::mudata
+.. currentmodule:: mudata
 .. autosummary::
    :toctree: generated
 
@@ -47,7 +37,6 @@
 
 ## Extensions
 ```{eval-rst}
-.. module::mudata
 .. autosummary::
    :toctree: generated
 
@@ -56,9 +45,16 @@
 
 Types used by the former:
 ```{eval-rst}
-.. module::mudata
 .. autosummary::
    :toctree: generated
 
    ExtensionNamespace
 ```
+
+## Settings
+```{eval-rst}
+.. autosummary::
+   :toctree: generated
+
+   set_options
+```

docs/conf.py

@@ -94,6 +94,7 @@
     "scanpy": ("https://scanpy.readthedocs.io/en/stable/", None),
     "numpy": ("https://numpy.org/doc/stable/", None),
     "fsspec": ("https://filesystem-spec.readthedocs.io/en/stable/", None),
+    "h5py": ("https://docs.h5py.org/en/stable/", None),
     "zarr": ("https://zarr.readthedocs.io/en/stable/", None),
 }
 

pyproject.toml

@@ -55,6 +55,7 @@ doc = [
   "docutils>=0.8,!=0.18.*,!=0.19.*",
   "ipykernel",
   "ipython",
+  "mudata[io]",
   "myst-nb>=1.1",
   "pandas",
   "sphinx>=8.1",
@@ -64,7 +65,7 @@ doc = [
   "sphinx-design",
   "sphinxcontrib-bibtex>=1",
   "sphinxcontrib-katex",
-  "sphinxext-opengraph",
+  "sphinxext-opengraph"
 ]
 
 [tool.hatch]

src/mudata/_core/config.py

@@ -24,7 +24,7 @@ class set_options:
     >>> with mudata.set_options(display_style="html"):
     ...     print("Options are applied here")
 
-    ... or globally:
+    or globally:
 
     >>> mudata.set_options(display_style="html")
     """