Documentation: Refactor Sphinx dependencies into setup.py

Author: amotl

.github/workflows/docs.yaml

@@ -20,7 +20,7 @@ jobs:
       fail-fast: false
       matrix:
         os: ["ubuntu-latest"]
-        python-version: ["3.11"]
+        python-version: ["3.12"]
 
     steps:
     - uses: actions/checkout@v4
@@ -31,7 +31,7 @@ jobs:
 
     - name: Install package and documentation dependencies
       run: |
-        uv pip install --system '.[develop]' --requirement=docs/requirements.txt
+        uv pip install --system '.[develop,docs]'
 
     - name: Run link checker
       run: |

.readthedocs.yml

@@ -14,7 +14,10 @@ build:
 
 python:
   install:
-    - requirements: docs/requirements.txt
+      - method: pip
+        path: .
+        extra_requirements:
+          - docs
 
 sphinx:
   configuration: docs/source/conf.py

DEVELOP.md

@@ -8,7 +8,7 @@ git clone https://github.com/kennethreitz/responder
 cd responder
 python3 -m venv .venv
 source .venv/bin/activate
-pip install --editable '.[graphql,develop,release,test]'
+pip install --editable '.[graphql,develop,docs,release,test]'
 ```
 
 Invoke linter and software tests.
@@ -20,3 +20,8 @@ Format code.
 ```shell
 poe format
 ```
+
+Documentation authoring.
+```shell
+poe docs-autobuild
+```

docs/requirements.txt

@@ -121,6 +121,10 @@ def run(self):
             "ruff; python_version>='3.7'",
             "validate-pyproject",
         ],
+        "docs": [
+            "alabaster<1.1",
+            "sphinx>=5,<9",
+        ],
         "graphql": ["graphene"],
         "release": ["build", "twine"],
         "test": ["pytest", "pytest-cov", "pytest-mock", "flask"],