LoginSign Up
← Back to all sparks
R

Read the Docs

COLLAB
Velocity5.0

Documentation hosting and building platform

readthedocs.org ↗

Read the Docs is rebuilding its build farm around uv and isolated builders, one week at a time.

build infrastructureuv migrationisolated buildersdependency maintenance
◆Current state
Weekly date-tagged releases, almost entirely build infrastructure. The visible work is a migration to uv-managed environments and isolated, ephemeral builders, shipped in small increments between routine dependency bumps. The most recent release is plumbing: skip build status when there is no commit, pin pip back, and point uv at the interpreter inside the venv.
◆Where it's heading
The isolated builder is the arc worth tracking — private repository support, an ephemeral builder script, and removal of the old scale-in protection path all point at builds that run in disposable environments. User-facing change is rare and arrives as a side effect, as when July's release moved images to Ubuntu 26.04 and Python 3.14.
◆Prediction
Expect the isolated builder to become the default path and further uv environment fixes; feature work should stay secondary until that migration finishes.

◆Recent moves

  1. 7d ago

    Build status skipped for commit-less builds; uv venv path fix

    Housekeeping on the uv migration — a venv interpreter path fix and a pip downgrade to avoid an editable-install requirement — plus skipping build status for commit-less builds.

    View source ↗
  2. 14d ago

    Isolated builders gain private-repo support and uv installs

    The isolated builder gets private repository access and learns to install uv on generic builders, moving it closer to handling the same workloads as the existing path.

    View source ↗
  3. 21d ago

    Dependency-only maintenance release

    A dependency-only release with no behavioral change.

    View source ↗
  4. 28d ago

    Ephemeral builders land; subproject aliases accept slashes

    The largest release in the window: ephemeral builders arrive via a dedicated script, subproject aliases accept slashes, and build notifications stop depending on the director.

    View source ↗
  5. 1mo ago

    Ubuntu 26.04 and Python 3.14 build images; automation fixes

    Build images move to Ubuntu 26.04 and Python 3.14 — the one change in this window that projects will notice — alongside automation rule fixes for commit status and version types.

    View source ↗
  6. 1mo ago

    Documentation link fixes

    Documentation link corrections only.

    View source ↗