Skip to content

RTD: Update OS version to ubuntu-lts-latest - #3509

Open
MikeOpenHWGroup wants to merge 1 commit into
openhwgroup:masterfrom
MikeOpenHWGroup:Update_OS_for_ReadTheDocs
Open

RTD: Update OS version to ubuntu-lts-latest#3509
MikeOpenHWGroup wants to merge 1 commit into
openhwgroup:masterfrom
MikeOpenHWGroup:Update_OS_for_ReadTheDocs

Conversation

@MikeOpenHWGroup

Copy link
Copy Markdown
Member

Automatic re-generation of CVA6 documentation on ReadTheDocs is failing because of Ubuntu-20.04 is no longer supported.

Automatic re-generation of CVA6 documentation on ReadTheDocs is failing because of Ubuntu-20.04 is no longer supported.
@ASintzoff

Copy link
Copy Markdown
Contributor

should we not use a specific version like ubuntu-26.04? Doing so will avoid any possible issue when ubuntu-lts-latestwill be switching to ubuntu-28.04.

This reminds me of #3443 by @cainria where Verible version is now explicitly specified

@cainria

cainria commented Aug 27, 2026

Copy link
Copy Markdown
Member

I agree with @ASintzoff but my opinion on the OS version freeze is weaker than on the Verible version freeze

The issue with Verible was that changing the formatting impacts all files, so all contributors have to upgrade simultaneously. For the Read the Docs OS, I think the issues would be mainly in the list of packages to install in the runner, which do not impact contributors.

Apart from that, freezing is better for reproducibility, but ubuntu-26.04 will eventually be deprecated in the long-term so we will need to change the version explicitly (preferably before the jobs fail next time 😉)

Comment thread .readthedocs.yaml

build:
os: "ubuntu-20.04"
os: "ubuntu-lts-latest"

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Following @ASintzoff suggestion:

Suggested change
os: "ubuntu-lts-latest"
os: "ubuntu-26.04"

And for reference, here are the docs: https://docs.readthedocs.com/platform/stable/config-file/v2.html#build-os

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.

3 participants