From e2c9735885a0f1bc9988d2943bacce86d2b38d2c Mon Sep 17 00:00:00 2001 From: Jordi Soucheiron Date: Tue, 17 Mar 2026 13:01:36 +0100 Subject: [PATCH 1/3] Fix Read the Docs build by using uv for dependency management The RTD build was failing because `extra_requirements: [dev, docs]` maps to `[project.optional-dependencies]`, but the project migrated to `[dependency-groups]` (PEP 735) with uv. This caused mkdocs-material to not be installed, breaking the docs build. Switch to `build.commands` with uv to properly resolve dependency groups. Co-Authored-By: Claude Opus 4.6 --- .readthedocs.yaml | 17 ++++++----------- 1 file changed, 6 insertions(+), 11 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 0be09bfe..57cb7b8b 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -1,19 +1,14 @@ version: 2 -mkdocs: - configuration: mkdocs.yml - formats: all build: os: ubuntu-22.04 tools: python: "3.10" - -python: - install: - - method: pip - path: . - extra_requirements: - - dev - - docs + commands: + - asdf plugin add uv + - asdf install uv latest + - asdf global uv latest + - uv sync --group docs + - uv run mkdocs build --clean --site-dir $READTHEDOCS_OUTPUT/html --config-file mkdocs.yml From 69d2a3fb0a5b24caa1e7af7daa62dcc62f7babc7 Mon Sep 17 00:00:00 2001 From: Jordi Soucheiron Date: Tue, 17 Mar 2026 15:08:08 +0100 Subject: [PATCH 2/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .readthedocs.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 57cb7b8b..7241a42b 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -10,5 +10,5 @@ build: - asdf plugin add uv - asdf install uv latest - asdf global uv latest - - uv sync --group docs + - uv sync --group docs --frozen - uv run mkdocs build --clean --site-dir $READTHEDOCS_OUTPUT/html --config-file mkdocs.yml From eec4193cbe79fd2327927544f54116816a898200 Mon Sep 17 00:00:00 2001 From: Jordi Soucheiron Date: Tue, 17 Mar 2026 15:09:45 +0100 Subject: [PATCH 3/3] Use pip to install uv instead of asdf Co-Authored-By: Claude Opus 4.6 --- .readthedocs.yaml | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/.readthedocs.yaml b/.readthedocs.yaml index 7241a42b..030b34df 100644 --- a/.readthedocs.yaml +++ b/.readthedocs.yaml @@ -7,8 +7,6 @@ build: tools: python: "3.10" commands: - - asdf plugin add uv - - asdf install uv latest - - asdf global uv latest + - pip install uv - uv sync --group docs --frozen - uv run mkdocs build --clean --site-dir $READTHEDOCS_OUTPUT/html --config-file mkdocs.yml