Merge pull request #472 into main

This changeset adds numpydoc to the documentation build requirements,
better distinguishing between parameters and return values.

docs/conf.py

@@ -44,7 +44,10 @@ def __getattr__(cls, name):
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["sphinx.ext.autodoc"]
+extensions = [
+    "sphinx.ext.autodoc",
+    "numpydoc",
+]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]

docs/requirements.txt

@@ -1,3 +1,4 @@
+numpydoc<1.6
 sphinx==4.5.0
 sphinx_rtd_theme==1.0.0
 readthedocs-sphinx-search==0.1.1