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

ci: docs preview builds on netlify currently limited to sphinx 7.1.2 #5543

Closed
bastimeyer opened this issue Sep 10, 2023 · 1 comment · Fixed by #6121
Closed

ci: docs preview builds on netlify currently limited to sphinx 7.1.2 #5543

bastimeyer opened this issue Sep 10, 2023 · 1 comment · Fixed by #6121

Comments

@bastimeyer
Copy link
Member

Netlify is still stuck on Python 3.8:

Since Sphinx 7.2.0 has already dropped support for Python 3.8, this means that all docs preview builds on netlify are built with Sphinx 7.1.2 instead of the latest one.

The docs dependencies must not be bumped when bumping would drop support for Python 3.8, or we would break the preview builds.

@bastimeyer
Copy link
Member Author

myst-parser >=4 has dropped support for py38 and py39. Netlify is still stuck on py38 and there's no upgrade in sight. They simply don't care about Python. Being stuck on myst-parser >=1.0.0,<4 could introduce problems in the future though if they introduce breaking changes which affect our documentation sources. Then Streamlink packagers who build the docs and man pages can't use the latest myst-parser versions. I doubt that there will be any breaking changes which will affect us, but it's possible.

Previews for GitHub-pages builds are still not supported, same as deploying to a different repo, so dropping Netlify in favor of GH actions for docs previews is currently impossible:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant