LoginSign Up
← Back to all sparks
R

Read the Docs

COLLAB
Velocity5.0

Documentation hosting and building platform

readthedocs.org ↗

Read the Docs ships a dated release every week, and this one is documentation and dependencies

documentation-hostinggithub-appbuild-toolingdependenciesopen-sourceweekly-releases
◆Current state
Read the Docs cuts a date-versioned release most weeks, each a generated list of merged pull requests. Recent substance has been in two areas: the GitHub App integration, where rate-limit handling stopped deleting repositories and commit-status errors no longer raise spurious notifications, and the build environment, where isolated builders gained private-repo support and uv-based installs. Around that, a steady flow of dependency bumps and documentation edits.
◆Where it's heading
The GitHub App work is the thread worth watching — the project is hardening the path where it syncs a user's repositories, and the fixes have been about failing safely when GitHub throttles rather than about new capability. Build tooling continues to move toward uv. On the documentation side, the supported-tools list keeps widening, with Starlight added and Zensical's introduction reworked, which tracks the platform's shift away from being Sphinx-shaped.
◆Prediction
Documentation keeps naming new generators before the platform's own tooling catches up to them, so expect build-side support work for the non-Sphinx generators the docs now list.

◆Recent moves

  1. 14d ago

    Docs edits, dependency bumps and a quieter GitHub App

    A light week: typo and grammar fixes across user docs, Starlight added to the supported tools list, a reworked Zensical intro, an environment variable for a dev setting, and a pip-tools dependency sweep. The only behavioural change is the GitHub App no longer raising notifications on 500 or rate-limit errors when creating commit statuses, which continues the previous release's throttling work.

    View source ↗
  2. 20d ago

    Rate-limited GitHub syncs no longer delete repositories

    The substantial release in this run: repositories are no longer deleted when GitHub rate-limits the sync, OAuth pages 100 items at a time, and API and test work lands alongside. Failing safely under throttling is the pattern the following week's notification fix extends.

    View source ↗
  3. 28d ago

    has_valid_clone made nullable before removal; tooling bumps

    has_valid_clone made nullable ahead of its removal, plus tooling bumps. Schema groundwork, visible only as a step in a sequence.

    View source ↗
  4. 1mo ago

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

    Build status skipped for commit-less builds and a uv virtualenv path fix. Build-environment maintenance of the kind that fills most of these releases.

    View source ↗
  5. 1mo ago

    Isolated builders gain private-repo support and uv installs

    Isolated builders gain private-repository support and uv-based dependency installs. The clearest recent step in moving the build environment onto uv.

    View source ↗
  6. 1mo ago

    Dependency-only maintenance release

    A dependency-only week. The cadence holds regardless of how much there is to ship, which is worth knowing when reading a thin release here.

    View source ↗