Back to Sphinx 8 until we figure out why 9 doesn't work.

Author: Julian

docs/requirements.in

@@ -1,7 +1,7 @@
 file:.
 furo
 lxml
-sphinx!=7.2.5
+sphinx<9  # sphinx 9 appears to have issues I haven't diagnosed
 sphinx-autoapi
 sphinx-autodoc-typehints
 sphinx-copybutton

docs/requirements.txt

@@ -18,7 +18,7 @@ certifi==2026.1.4
     # via requests
 charset-normalizer==3.4.4
     # via requests
-docutils==0.22.4
+docutils==0.21.2
     # via sphinx
 furo==2025.12.19
     # via -r docs/requirements.in
@@ -60,6 +60,8 @@ requests==2.32.5
     #   sphinx
     #   sphinxcontrib-spelling
 roman-numerals==4.1.0
+    # via roman-numerals-py
+roman-numerals-py==4.1.0
     # via sphinx
 rpds-py==0.30.0
     # via
@@ -69,7 +71,7 @@ snowballstemmer==3.0.1
     # via sphinx
 soupsieve==2.8.1
     # via beautifulsoup4
-sphinx==9.1.0
+sphinx==8.2.3
     # via
     #   -r docs/requirements.in
     #   furo
@@ -82,7 +84,7 @@ sphinx==9.1.0
     #   sphinxext-opengraph
 sphinx-autoapi==3.6.1
     # via -r docs/requirements.in
-sphinx-autodoc-typehints==3.6.2
+sphinx-autodoc-typehints==3.5.2
     # via -r docs/requirements.in
 sphinx-basic-ng==1.0.0b2
     # via furo