Problem
Our ReadTheDocs build is failing because ubuntu-lts-latest moved from 24.04 to 26.04, and 26.04 is incompatible with mambaforge-latest (aliases to mambaforge-23.11.0-0). mambaforge is deprecated wholesale by ReadTheDocs anyway, in favor of the miniforge3-* tags (e.g. miniforge3-latest).
Current .readthedocs.yml:
build:
os: ubuntu-lts-latest
tools:
python: "mambaforge-latest"How do we want to resolve this?
Decision 1: keep deprecated mambaforge, or migrate to miniforge3?
Suggestion: migrate to miniforge3.
- If mambaforge: pin
build.os to ubuntu-24-04.
- If miniforge3: see decision 2.
Decision 2 (only if migrating to miniforge3): keep ubuntu-lts-latest, or pin to ubuntu-24-04 or ubuntu-26-04?
Suggestion: keep ubuntu-lts-latest and fix compatibility issues as they come up.
Decision 3: use the -latest tag (for whichever of mamba/miniforge we pick), or a pinned version?
Suggestion: use -latest and fix as issues arise.
Problem
Our ReadTheDocs build is failing because
ubuntu-lts-latestmoved from 24.04 to 26.04, and 26.04 is incompatible withmambaforge-latest(aliases tomambaforge-23.11.0-0).mambaforgeis deprecated wholesale by ReadTheDocs anyway, in favor of theminiforge3-*tags (e.g.miniforge3-latest).Current
.readthedocs.yml:How do we want to resolve this?
Decision 1: keep deprecated mambaforge, or migrate to miniforge3?
Suggestion: migrate to miniforge3.
build.ostoubuntu-24-04.Decision 2 (only if migrating to miniforge3): keep
ubuntu-lts-latest, or pin toubuntu-24-04orubuntu-26-04?Suggestion: keep
ubuntu-lts-latestand fix compatibility issues as they come up.Decision 3: use the
-latesttag (for whichever of mamba/miniforge we pick), or a pinned version?Suggestion: use
-latestand fix as issues arise.