Fix Read the Docs build by using uv for dependency management#367
Merged
Jordi Soucheiron (jsoucheiron) merged 3 commits intomasterfrom Mar 18, 2026
Merged
Conversation
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 <noreply@anthropic.com>
Copilot started reviewing on behalf of
Jordi Soucheiron (jsoucheiron)
March 17, 2026 12:02
View session
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the Read the Docs configuration to restore docs builds after the project migrated from optional-dependencies extras to PEP 735 dependency-groups managed by uv.
Changes:
- Remove RTD’s
python.installpip +extra_requirementsflow that no longer matches the project dependency model. - Switch RTD to custom
build.commandsthat install thedocsdependency group viauvand runmkdocs build.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
.readthedocs.yaml
Outdated
Comment on lines
+10
to
+12
| - asdf plugin add uv | ||
| - asdf install uv latest | ||
| - asdf global uv latest |
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Ignacio Bolonio (ignaciobolonio)
approved these changes
Mar 17, 2026
Ramon (w0rmr1d3r)
approved these changes
Mar 17, 2026
Jordi Soucheiron (jsoucheiron)
deleted the
fix/readthedocs-uv-dependency-groups
branch
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.readthedocs.yamlusedextra_requirements: [dev, docs]which maps to[project.optional-dependencies], but the project migrated to[dependency-groups](PEP 735) with uv in Migrate to uv native commands for package management #356mkdocs-materialto not be installed (WARNING: cfripper 1.20.0 does not provide the extra 'docs'), breaking the docs buildbuild.commandswith uv to properly install dependency groups viauv sync --group docsTest plan
🤖 Generated with Claude Code