docs: more doc fixes

henryiii · henryiii · commit 4ea1ed737d17 · 2025-08-08T14:33:14.000-04:00
Signed-off-by: Henry Schreiner &lt;henryschreineriii@gmail.com&gt;
diff --git a/docs/conf.py b/docs/conf.py
@@ -22,9 +22,11 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    "matplotlib.sphinxext.plot_directive",
     "myst_parser",
     "nbsphinx",
     "sphinx.ext.autodoc",
+    "sphinx.ext.intersphinx",
     "sphinx.ext.mathjax",
     "sphinx.ext.napoleon",
     "sphinx_copybutton",
@@ -49,6 +51,11 @@
 ]
 
 
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3", None),
+    "boost_histogram": ("https://boost-histogram.readthedocs.io/en/latest", None),
+}
+
 # -- Options for HTML output -------------------------------------------------
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
diff --git a/docs/reference/hist.accumulators.rst b/docs/reference/hist.accumulators.rst
@@ -3,5 +3,5 @@ hist.accumulators module
 
 .. automodule:: hist.accumulators
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.axestuple.rst b/docs/reference/hist.axestuple.rst
@@ -3,5 +3,5 @@ hist.axestuple module
 
 .. automodule:: hist.axestuple
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.axis.rst b/docs/reference/hist.axis.rst
@@ -3,8 +3,8 @@ hist.axis package
 
 .. automodule:: hist.axis
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
 
 Submodules
 ----------
diff --git a/docs/reference/hist.axis.transform.rst b/docs/reference/hist.axis.transform.rst
@@ -3,5 +3,5 @@ hist.axis.transform module
 
 .. automodule:: hist.axis.transform
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.basehist.rst b/docs/reference/hist.basehist.rst
@@ -3,5 +3,5 @@ hist.basehist module
 
 .. automodule:: hist.basehist
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.classichist.rst b/docs/reference/hist.classichist.rst
@@ -3,5 +3,5 @@ hist.classichist module
 
 .. automodule:: hist.classichist
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.dask.hist.rst b/docs/reference/hist.dask.hist.rst
@@ -3,5 +3,5 @@ hist.dask.hist module
 
 .. automodule:: hist.dask.hist
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.dask.namedhist.rst b/docs/reference/hist.dask.namedhist.rst
@@ -3,5 +3,5 @@ hist.dask.namedhist module
 
 .. automodule:: hist.dask.namedhist
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.dask.rst b/docs/reference/hist.dask.rst
@@ -3,8 +3,8 @@ hist.dask package
 
 .. automodule:: hist.dask
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
 
 Submodules
 ----------
diff --git a/docs/reference/hist.hist.rst b/docs/reference/hist.hist.rst
@@ -3,5 +3,5 @@ hist.hist module
 
 .. automodule:: hist.hist
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.intervals.rst b/docs/reference/hist.intervals.rst
@@ -3,5 +3,5 @@ hist.intervals module
 
 .. automodule:: hist.intervals
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.namedhist.rst b/docs/reference/hist.namedhist.rst
@@ -3,5 +3,5 @@ hist.namedhist module
 
 .. automodule:: hist.namedhist
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.numpy.rst b/docs/reference/hist.numpy.rst
@@ -3,5 +3,5 @@ hist.numpy module
 
 .. automodule:: hist.numpy
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.plot.rst b/docs/reference/hist.plot.rst
@@ -3,5 +3,5 @@ hist.plot module
 
 .. automodule:: hist.plot
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.quick_construct.rst b/docs/reference/hist.quick_construct.rst
@@ -3,5 +3,5 @@ hist.quick\_construct module
 
 .. automodule:: hist.quick_construct
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.rst b/docs/reference/hist.rst
@@ -3,8 +3,8 @@ hist package
 
 .. automodule:: hist
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
 
 Subpackages
 -----------
@@ -26,6 +26,7 @@ Submodules
    hist.basehist
    hist.classichist
    hist.hist
+   hist.interop
    hist.intervals
    hist.namedhist
    hist.numpy
diff --git a/docs/reference/hist.stack.rst b/docs/reference/hist.stack.rst
@@ -3,5 +3,5 @@ hist.stack module
 
 .. automodule:: hist.stack
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.storage.rst b/docs/reference/hist.storage.rst
@@ -3,5 +3,5 @@ hist.storage module
 
 .. automodule:: hist.storage
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.svgplots.rst b/docs/reference/hist.svgplots.rst
@@ -3,5 +3,5 @@ hist.svgplots module
 
 .. automodule:: hist.svgplots
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.svgutils.rst b/docs/reference/hist.svgutils.rst
@@ -3,5 +3,5 @@ hist.svgutils module
 
 .. automodule:: hist.svgutils
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
diff --git a/docs/reference/hist.tag.rst b/docs/reference/hist.tag.rst
@@ -3,6 +3,6 @@ hist.tag module
 
 .. automodule:: hist.tag
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
    :exclude-members: Slicer
diff --git a/docs/reference/hist.version.rst b/docs/reference/hist.version.rst
@@ -3,5 +3,5 @@ hist.version module
 
 .. automodule:: hist.version
    :members:
-   :undoc-members:
    :show-inheritance:
+   :undoc-members:
