Fix uv resolution: add Python >=3.12 markers to docs deps

uv does universal resolution across all versions in requires-python
(>=3.10), so Sphinx 9.1.0 fails even on Python 3.13. Fix by:

- Adding 'python_version >= 3.12' markers to all docs group deps
- Removing docs include from dev group (keep them independent)
- Code quality CI uses 'uv sync --group docs' explicitly
- RTD installs both dev and docs groups

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Paul V Craven

.github/workflows/code_quality.yml

@@ -29,7 +29,7 @@ jobs:
           enable-cache: true
 
       - name: Sync UV project
-        run: uv sync
+        run: uv sync --group docs
 
       - name: Formatting (Ruff)
         if: success()
@@ -75,7 +75,7 @@ jobs:
           enable-cache: true
 
       - name: Sync UV Project
-        run: uv sync
+        run: uv sync --group docs
 
       - name: build-docs
         run: uv run make.py docs-full

.readthedocs.yaml

@@ -15,6 +15,7 @@ python:
     - method: uv
       command: sync
       groups:
+        - dev
         - docs
 
 # Build PDF & ePub

pyproject.toml

@@ -40,15 +40,15 @@ extras = [
 ]
 # Doc building (requires Python >=3.12 due to Sphinx 9.x)
 docs = [
-    "sphinx==9.1.0",
-    "sphinx_rtd_theme==3.1.0",
-    "sphinx-rtd-dark-mode==1.3.0",
-    "sphinx-autobuild==2024.10.3",
-    "sphinx-copybutton==0.5.2",
-    "sphinx-sitemap==2.6.0",
-    "sphinx-togglebutton==0.3.2",
-    "pygments==2.19.1",
-    "docutils==0.21.2",
+    "sphinx==9.1.0; python_version >= '3.12'",
+    "sphinx_rtd_theme==3.1.0; python_version >= '3.12'",
+    "sphinx-rtd-dark-mode==1.3.0; python_version >= '3.12'",
+    "sphinx-autobuild==2024.10.3; python_version >= '3.12'",
+    "sphinx-copybutton==0.5.2; python_version >= '3.12'",
+    "sphinx-sitemap==2.6.0; python_version >= '3.12'",
+    "sphinx-togglebutton==0.3.2; python_version >= '3.12'",
+    "pygments==2.19.1; python_version >= '3.12'",
+    "docutils==0.21.2; python_version >= '3.12'",
 ]
 # Used for dev work
 dev = [
@@ -66,7 +66,6 @@ dev = [
     "wheel",
     "bottle",            # Used for web testing playground
     {include-group = "extras"},
-    {include-group = "docs"},
 ]
 
 # Testing only