Fix Read the Docs builds broken by Ubuntu 26.04 image#1289
Open
gagelarsen wants to merge 1 commit into
Open
Conversation
Read the Docs' ubuntu-lts-latest image now resolves to Ubuntu 26.04, which only supports the miniforge3 toolchain. The deprecated mambaforge-4.10 fails to install on it, breaking every docs build since late June (EnvironmentLocationNotFound during asdf install). conda-forge retired Mambaforge in favor of Miniforge3 (identical since Miniforge3-23.3.1-0), and Read the Docs deprecated all mambaforge-* values accordingly. See readthedocs/readthedocs.org#13149. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This merge request fixes the Read the Docs build, which has been failing for every PR since late June (e.g. #1277, #1282, #1284, #1285, #1287, #1288). Read the Docs flipped its
ubuntu-lts-latestalias to Ubuntu 26.04, and that image only supports theminiforge3-*conda toolchain. The deprecatedmambaforge-4.10pinned in.readthedocs.yamlfails to install on it:conda-forge retired Mambaforge in favor of Miniforge3 (functionally identical since Miniforge3-23.3.1-0), and Read the Docs deprecated all
mambaforge-*values. A Read the Docs maintainer confirmedminiforge3-*is the supported replacement on the new image (readthedocs/readthedocs.org#13149); other projects hit by the same break applied the same one-line fix (e.g. MDAnalysis/mdanalysis#5410).Changes Made to Code
.readthedocs.yaml:build.tools.pythonchanged from deprecatedmambaforge-4.10tominiforge3-latest.Related PRs, Issues, and Discussions
docs/readthedocs.orgcheck (and therefore Merge Gatekeeper) on all open PRs, including Fix database access warning during app initialization with Django 5 #1288.Additional Notes
docs/readthedocs.org:tethys-platformcheck on this PR is the real verification — it builds with this config.Quality Checks
🤖 Generated with Claude Code