Fix failing rtd build

.readthedocs.yaml

@@ -14,3 +14,11 @@ python:
 sphinx:
   configuration: docs/source/conf.py
   fail_on_warning: true
+
+# Install the documentation dependencies with pip when building on readthedocs
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

pyproject.toml

@@ -38,10 +38,26 @@ dependencies = [
 
 
 [project.optional-dependencies]
+
+docs = [
+  "astroid>=3", # RTD issue https://github.com/readthedocs/readthedocs.org/issues/11975
+  "sphinx>=7.3.7",
+  "sphinx-autoapi>=3.3.3",
+  "sphinx-rtd-theme>=1.3.0rc1",
+  "ipykernel>=6.29.5",
+  # To build locally, pandoc must also be installed locally for nbsphinx
+  # https://pandoc.org/installing.html
+  # May require a computer restart (at least on Windows)
+  "nbsphinx>=0.9.5",
+]
+
 tests = [
   "pytest >= 8.3.1",
   ]
 
+
+
+
 [tool.setuptools.packages.find]
 where = ["src"]
 
@@ -50,6 +66,7 @@ where = ["src"]
 skip = '*.ipynb'
 # Add false positives found by codespell to ignore-words-list
 ignore-words-list = """
+astroid,
 hax,
 vax"""