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

Build against Sphinx pre-releases/development branches to help test theme compatibility/readiness #116

Open
pradyunsg opened this issue Oct 20, 2022 · 4 comments
Labels
enhancement New feature or request

Comments

@pradyunsg
Copy link
Collaborator

pradyunsg commented Oct 20, 2022

Follows from #114 -- it would be good to build websites with latest Sphinx prerelease and latest development branch of Sphinx, to provide meaningful information to the developers of themes and Sphinx.

/cc @AA-Turner -- do you think this would be meaningfully useful to Sphinx's maintainers?
/cc @humitos who has shown how to do this with a build of this site on RTD, in #114.

@pradyunsg
Copy link
Collaborator Author

@humitos Is there any way to do scheduled rebuilds on RTD? Part of why this site is on GA + GitHub Pages (other than historic reasons) is that GA allows us to perform regular rebuilds of the site.

@humitos
Copy link

humitos commented Oct 20, 2022

Is there any way to do scheduled rebuilds on RTD?

Hrm, I'd say it's not possible, no 😞 At least in an automated way with the default features.

That said, you could always do it using the APIv3 (https://docs.readthedocs.io/en/stable/api/v3.html#build-triggering) and a cronjob somewhere else -- but I suppose that's one of the things you want to avoid 😄

@AA-Turner
Copy link

do you think this would be meaningfully useful to Sphinx's maintainers?

Unsure. What would I as a Sphinx maintainer be looking for here?

A

@pradyunsg
Copy link
Collaborator Author

What would I as a Sphinx maintainer be looking for here?

If I knew that, I wouldn't ask. :P

More seriously, I'm guessing it'd be a reasonable gauge for "how does the newer version affect themes" and if the theme ecosystem is ready for the newer Sphinx version -- point of the pre-releases is to provide early testing, and this would probably serve as some of that. :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

3 participants