Skip to content

Fix RTD build: use ubuntu-lts-latest and Python 3.14#28

Merged
chrizzFTD merged 2 commits into
mainfrom
cursor/fix-rtd-build-1981
Jun 27, 2026
Merged

Fix RTD build: use ubuntu-lts-latest and Python 3.14#28
chrizzFTD merged 2 commits into
mainfrom
cursor/fix-rtd-build-1981

Conversation

@chrizzFTD

Copy link
Copy Markdown
Owner

Fixes the Read the Docs build failure caused by the deprecated ubuntu-20.04 value in .readthedocs.yml.

Changes

  • Set build.os to ubuntu-lts-latest so RTD uses its current Ubuntu LTS image and stays supported as RTD updates the alias
  • Bump build.tools.python from 3.12 to 3.14, matching the project's GitHub Actions CI matrix

Context

RTD build #33333129 failed during config validation:

Config validation error in build.os. Expected one of (ubuntu-22.04, ubuntu-24.04, ubuntu-26.04, ubuntu-lts-latest), got type str (ubuntu-20.04).

No other files need changes; docs dependencies and Sphinx config are unchanged.

Open in Web Open in Cursor 

cursoragent and others added 2 commits June 27, 2026 10:21
Read the Docs no longer accepts ubuntu-20.04 in build.os. Update to
ubuntu-lts-latest so the build stays on RTD's current Ubuntu LTS image,
and bump the Python toolchain to 3.14 to match CI.

Co-authored-by: chrizzftd <chrizzFTD@users.noreply.github.com>
hoverxref is incompatible with Sphinx 9 (TypeError on _Opt objects) and
is deprecated in favor of RTD's native Link previews addon.

Co-authored-by: chrizzftd <chrizzFTD@users.noreply.github.com>
@chrizzFTD chrizzFTD merged commit f5f55a2 into main Jun 27, 2026
4 checks passed
@chrizzFTD chrizzFTD deleted the cursor/fix-rtd-build-1981 branch June 27, 2026 10:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants