LoginSign Up
← Back to all sparks
R

Read the Docs

COLLAB
Velocity5.0

Documentation hosting and building platform

readthedocs.org ↗

Read the Docs adds project-scoped API keys for uploading built docs.

documentation-hostingdirect-uploadapi-keysbuild-toolingsecurityweekly-releases
◆Current state
Read the Docs ships a dated release most weeks. October moved builds to Python 3.14 and Ubuntu 26.04, banned git:// URLs and added temporary build variables. The 10 November release adds project-scoped API keys for artifact uploads, managed from the project dashboard, so CI can push prebuilt docs without an account-wide token.
◆Where it's heading
The direct-upload work that started with September design docs is now usable end to end: projects can build docs elsewhere and push the output with a narrow key. Read the Docs is becoming a host for docs built anywhere, not only a build service.
◆Prediction
Expect more around direct upload, such as CI examples, upload limits or key permissions, since the last three months of entries keep returning to it.

◆Recent moves

  1. 3d ago

    Project-scoped API keys for uploading built docs

    Adds API keys scoped to a single project for artifact uploads, managed from the dashboard, plus smarter ordering of repositories to import. It makes the direct-upload path safe to use from CI without account-wide tokens.

    View source ↗
  2. 10d ago

    Security scanner build and a scoped API keys design doc

    Mostly internal: an OSS security scanner build with a threat model, a primary-key migration, and the build-isolated import path skipping legacy builds. The scoped API keys design doc is the one item that points at a future user-facing change.

    View source ↗
  3. 17d ago

    Redirect form tweaks and slug-change notices

    Admin and API internals, a pre-filled redirect form and a notice when a version slug changes. A light week.

    View source ↗
  4. 23d ago

    Defaults move to Python 3.14 and Ubuntu 26.04

    Builds now default to Python 3.14 and Ubuntu 26.04, git:// URLs are rejected, search ranks pages by their best section, and the eMudhra CAs are distrusted. The default bumps can change existing builds that don't pin versions.

    View source ↗
  5. 1mo ago

    No commit status on closed PR previews

    Stops commit statuses for closed PR previews and logs rclone errors, plus dependency updates.

    View source ↗
  6. 1mo ago

    Release branch merge, no listed changes

    A release-branch merge with no listed changes.

    View source ↗