GeezerVison is showing github.com — Increase the build frequency of English HTML stable (and pre-release?) documentation · Issue #163 · python/docsbuild-scripts
Increase the build frequency of English HTML stable (and pre-release?) documentation #163DescriptionIt's come up a few times that increasing the frequency of builds for /3/ would be useful for core developers and contributors (potentially also /dev/ and the pre-release versions, but I'm happy to start small).
I'm led to believe that the expensive bit of the builds is the large matrix of versions and languages and the and the ePUB, PDF, etc, formats, so I wondered if it would be possible to configure a distinct task to regenerate only the English HTML documentation every e.g. 4 or 6 hours?
I believe that the config for this is located at https://github.com/python/psf-salt/blob/main/salt/docs/init.sls, though I'm not sure.
cc: @JulienPalard @hugovk @ezio-melotti for thoughts and comments
A
P.S.: I've tried a few times in the past to find out where the documentation build logs are, or at least to find out when the last rebuild was, without much success. The PSF-Salt docs have some information, and the docs themselves have a last built date (sans time) -- if anyone could point me in the right direction, I'd be very grateful! Reacted by Hugo van Kemenade and Blaise Pabon Activityhugovk commented on Sep 29, 2023 I'm supportive.
Once a day feels too infrequent for the English HTML docs, I'd like to see them built more frequently, maybe even triggering a deploy from merge.
But if on cron, perhaps we could do hourly, or every 15 minutes.
The download artifacts and translations could remain on a daily schedule.
P.S.: I've tried a few times in the past to find out where the documentation build logs are, or at least to find out when the last rebuild was, without much success. The PSF-Salt docs have some information, and the docs themselves have a last built date (sans time) -- if anyone could point me in the right direction, I'd be very grateful!
I think it requires ssh access to the server?
It would be good to know the build times for various builds, and see the logs.
the docs themselves have a last built date (sans time)
Adding the time would be a helpful addition. AA-Turner commented on Sep 29, 2023 JulienPalard commented on Sep 29, 2023 It was the case previously: python/psf-salt@38ee687
But building without PDF artifacts leads, at least on version bumps, to a few hours with HTML but without PDF.
This lead to spam on docs@ with people complaining about the absence of PDF (looks like they're used!).
See also: python/psf-salt@38ee687
See also: 1a0ad2e AA-Turner commented on Sep 29, 2023
a few hours with HTML but without PDF.
Is it possible to not delete the PDFs (ie save them and only refresh every 24h?) JulienPalard commented on Oct 2, 2023 encukou commented on Oct 4, 2023 Reacted by Adam Turner and Hugo van Kemenade AA-Turner commented on Sep 25, 2024 AA-Turner commented on Oct 2, 2024 Reacted by Hugo van Kemenade
MetadataMetadataDevelopmentNo branches or pull requestsIssue actions
|