use a numpydoc 1.7.0rc0.dev0

This has a fix for NamedTuple documentation (numpy/numpydoc#527)

Author: fohrloop

docs/source/conf.py

@@ -22,10 +22,12 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    # Markdown (MyST) format support for Sphinx
-    "myst_parser",
     # Adds support for NumPy style docstrings for autodoc
+    # Note: numpydoc must be listed before myst_parser in order to make the
+    # NamedTuples fix (https://github.com/numpy/numpydoc/pull/527) work.
     "numpydoc",
+    # Markdown (MyST) format support for Sphinx
+    "myst_parser",
     # Sphinx Design adds some sphinx directives for UI components
     # See: https://sphinx-design.readthedocs.io/
     "sphinx_design",

pyproject.toml

@@ -37,7 +37,9 @@ doc = [
     "sphinx-copybutton~=0.5.2",
     "myst-parser~=2.0.0",
     "sphinx-book-theme~=1.1.0",
-    "numpydoc"
+    # a numpydoc 1.7.0rc0.dev0. This one has https://github.com/numpy/numpydoc/pull/527 merged
+    # At some point: Can use 1.7.0 (which is not available in PyPI at the time of writing)
+    "numpydoc @ git+https://github.com/numpy/numpydoc.git@46f532a824639a97479039fc122533915cdfa10f"
 ]
 dev = [
     "sphinx-autobuild",