Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: unbreak RTD and fix GitHub CI #488

Closed
wants to merge 3 commits into from
Closed

docs: unbreak RTD and fix GitHub CI #488

wants to merge 3 commits into from

Conversation

jktjkt
Copy link
Collaborator

@jktjkt jktjkt commented Jan 24, 2024

No description provided.

In tox v4, "reuse of environments" was disabled [1]. This is then later
explained [2] to refer to exactly that thing which we were using for
inheriting the dependencies from the top-level testenv all the way to
the docs build. That's why the docs build in GitHub CI started failing.

[1] https://tox.wiki/en/4.11.4/upgrading.html#reuse-of-environments
[2] https://tox.wiki/en/4.11.4/upgrading.html#packaging-configuration-and-inheritance

Change-Id: I26378d55751f6719a6daee1cdcc57563243c1b01
@jktjkt jktjkt force-pushed the wip/docs branch 2 times, most recently from 3f38fe9 to 303a579 Compare January 24, 2024 18:18
Now that the top-level `tox` inheritance is fixed, there's no need to
repeat the dependencies across several files.

We're going to require a newer Sphinx because some automagic version
deps bring sphinxcontrib-applehelp which now requires Sphinx v5. While
we're at it, let's bring this to Sphinx v7. This required that `lang`
change (changed in v5).

Of course, because of the version pinning hell, Sphinx v7 requires newer
myst-parser, so let's be bold and go all the way to v2. What could
possibly go wrong?

This (partially) reverts commit 47c8962.

Change-Id: Ie60ed866b14ac7ac424ea2cea05c99d0f996f854
@jktjkt jktjkt changed the title docs: try to unbreak the readthedocs.io build docs: unbreak RTD and fix GitHub CI Jan 24, 2024
It was failing with a message:

  Config validation error in build.os. Value os not found.

Apparently, the v2 config file is mandatory, so let's do that.

Change-Id: I267d5314db026de532b2b6644f500d25de08e343
@jktjkt jktjkt closed this Mar 13, 2024
@jktjkt jktjkt deleted the wip/docs branch March 13, 2024 20:31
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.

1 participant