docs: use dependency groups for deps

- This makes it consistent with other dev deps.
- Uses partial jobs override introduced in
  readthedocs/readthedocs.org#11710

.github/workflows/docs.yml

@@ -34,7 +34,7 @@ jobs:
         sudo apt update
         sudo apt install -y graphviz
     - name: Install Python dependencies
-      run: uv pip install --system -r docs/requirements.txt
+      run: uv sync --no-sources --only-group docs --frozen
     - name: Sphinx build
       run: |
         echo "::add-matcher::.github/matchers/sphinx.json"

.github/workflows/linkcheck.yml

@@ -8,12 +8,10 @@ on:
   push:
     paths:
     - docs/**.rst
-    - docs/requirements.txt
     - .github/workflows/linkcheck.yml
   pull_request:
     paths:
     - docs/**.rst
-    - docs/requirements.txt
     - .github/workflows/linkcheck.yml
   schedule:
   - cron: 30 5 * * *
@@ -38,8 +36,7 @@ jobs:
         sudo apt update
         sudo apt install -y graphviz
     - name: Install Python dependencies
-      run: |
-        uv pip install --system -r docs/requirements.txt
+      run: uv sync --no-sources --only-group docs --frozen
     - name: Sphinx linkcheck
       run: |
         ./ci/run-docs linkcheck

.github/workflows/setup.yml

@@ -115,7 +115,7 @@ jobs:
         sudo apt update
         sudo apt install -y graphviz pandoc
     - name: Install Python dependencies
-      run: uv pip install --system -r docs/requirements.txt
+      run: uv sync --no-sources --only-group docs --frozen
     - name: Sphinx build
       run: ./ci/run-docs
     - name: Convert release notes

.readthedocs.yml

@@ -18,11 +18,16 @@ build:
   apt_packages:
   # Graphviz is needed for sphinx.ext.graphviz
   - graphviz
-
-# Optionally set the version of Python and requirements required to build your docs
-python:
-  install:
-  - requirements: docs/requirements.txt
+  jobs:
+    create_environment:
+    - asdf plugin add uv
+    - asdf install uv latest
+    - asdf global uv latest
+    install:
+    - uv sync --no-sources --only-group docs --frozen
+    build:
+      html:
+      - .venv/bin/sphinx-build -T -b html -d docs/_build/doctrees -D language=$READTHEDOCS_LANGUAGE docs $READTHEDOCS_OUTPUT/html
 
 # Avoid cloning submodules
 submodules:

docs/contributing/index.rst

@@ -53,8 +53,9 @@ Please respect these guidelines while writing:
     2. Once the rewrite is reviewed, polished, and merged, change the structure of the paragraphs in another PR.
 
 Documentation can be also edited and built locally, the Python requirements are
-in `docs/requirements.txt`. You will also need :program:`graphviz` to build the
-documentation.
+in the ``docs`` dependency group in :file:`pyproject.toml`.
+
+You will also need :program:`graphviz` to build the documentation.
 
 .. hint::
 

pyproject.toml

@@ -12,10 +12,24 @@ dev = [
   "reuse==5.0.2",
   "scour==0.38.2",
   "tinyunicodeblock==1.3",
+  {include-group = "docs"},
   {include-group = "lint"},
   {include-group = "test"},
   {include-group = "types"}
 ]
+docs = [
+  "furo==2024.8.6",
+  "jinja2>=3.1.4",
+  "matplotlib==3.9.2",
+  "pillow>=10.3.0",
+  "pygments==2.18.0",
+  "requests>=2.32.0",
+  "Sphinx==8.1.3",
+  "sphinx-copybutton==0.5.2",
+  "sphinx-jsonschema==1.19.1",
+  "sphinxcontrib-httpdomain==1.8.1",
+  "sphinxext-opengraph==0.9.1"
+]
 lint = [
   {include-group = "pylint"},
   {include-group = "pre-commit"}