Skip to content

Conversation

@davidt0x
Copy link
Contributor

@davidt0x davidt0x commented Jan 8, 2026

This pull request updates the Read the Docs build configuration to use a more modern and reproducible setup. The main change is moving from a requirements-based Python environment to a uv-managed environment, with explicit steps for installing dependencies and setting up the build environment. This should improve consistency and reliability of documentation builds. I have also updated the Github webhook integration now so that build should be triggered properly. This should fix #563

Read the Docs configuration modernization:

  • Updated .readthedocs.yml to use the build section with os, python, and explicit pre_create_environment, create_environment, and install steps, leveraging asdf and uv for environment management instead of the previous requirements file approach.
  • Removed the python.install section and the use of docs/sphinx/requirements.txt in favor of syncing dependencies with uv using the docs group. [1] [2]

Dependency management:

  • Removed the requirements installation line from docs/sphinx/requirements.txt, indicating that dependencies are now managed via uv and the docs group.

davidt0x and others added 5 commits January 7, 2026 13:49
The error is coming from Read the Docs now requiring a build.os (and build.tools.python) section in v2 configs. Add a build: block (and fix the indentation under python.install) and the config should validate.
@davidt0x davidt0x merged commit 4cc5afa into development Jan 8, 2026
77 checks passed
@davidt0x davidt0x deleted the fix/readthedocs branch January 8, 2026 20:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants