Read the Docs Drops git:// Projects and Defaults to Python 3.14
Read the Docs release 2026.10.21 bans the git:// scheme, defaults builds to Python 3.14 and Ubuntu 26.04, and ranks search hits by best-matching section.

Read the Docs no longer accepts projects whose repository URL uses the git:// scheme, according to the 2026.10.21 release notes published Oct. 21. The release also moves the default build image to Python 3.14 and Ubuntu 26.04, and changes how search ranks pages.
The git:// scheme is no longer allowed for projects
Pull request 13423 removes git:// from the URL schemes a project can use. The scheme is the old unauthenticated Git protocol. A project still configured with it needs an https:// or SSH URL.
New builds default to Python 3.14 and Ubuntu 26.04
Pull requests 13328 and 13327 raise the default Python version to 3.14 and the default Ubuntu version to 26.04. The first came from ulgens, a new contributor. Projects that pin a version in their build config are unaffected. Projects on the default get a different interpreter and system packages on their next build.
Search ranks a page by its best-matching section
Pull request 13425, from contributor ericholscher, makes search score each page by the section that matches best, instead of scoring the page as a whole. A long page with one relevant section can now rank higher.
A sitemap, certificate and build-log fixes also shipped
Pull request 13441 generates a sitemap.xml and fixes canonical URLs for the docs-upload mirror. Pull requests 13452 and 13453 upgrade certifi to distrust the compromised eMudhra certificate authorities. Stripe API calls now use certifi’s bundle. The GitHub App now logs why an event did not trigger a build (13431), and uploaded builds report why they were cancelled (13433). The previous release, 2026.10.13post2, came Oct. 13.
Key takeaways
- Projects using
git://URLs are no longer accepted. - The default build image is now Python 3.14 on Ubuntu 26.04.
- Search ranks pages by their best-matching section.
- The release distrusts the compromised eMudhra certificate authorities.
The take
We think the default-version bump is the change most likely to break a build. A default means you never made a choice. When it moves, your build moves with it. The fix is cheap: pin the Python and Ubuntu versions in your build config.
Do that now. Then check your repository URL. If it starts with git://, change it before the next sync fails.


