ci: build all doc versions in one run and open a single deploy PR#15266
Merged
Conversation
github-actions
Bot
added
the
github_actions
Contributor
📖 Documentation PreviewNo RST documentation pages changed in this PR. Last updated: Thu, 02 Jul 2026 13:19:12 GMT |
The nightly build fanned out one sphinxbuild.yml run per branch, and each run opened its own gh-pages deploy PR — 5+ PRs every night. Consolidate into one run that produces one PR. - build-docs.yml: new reusable (workflow_call) workflow holding all build + stage logic, parameterized by branch/ref. Intermediate artifacts are namespaced per branch so multiple versions can build in one run. - sphinxbuild.yml: PR/push CI now calls build-docs, keeping only link-check and the Netlify preview. Deploy logic removed. - deploy-docs.yml: new scheduled workflow. A matrix over master + every stable branch builds each version via build-docs (fail-fast disabled), then a single deploy job applies all versions to gh-pages and opens ONE pull request. A version that fails to build is simply not deployed, without blocking others. - schedule-builds.yml: removed; the matrix replaces the dispatch fan-out. The go.php and user_manual language redirects are now taken from the default branch for every version (previously per-branch); they are branch-agnostic stubs. Assisted-by: ClaudeCode:claude-opus-4-8 Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
skjnldsv
force-pushed
the
feature/consolidate-deploy-single-pr
branch
from
bae798b to
840501f
Compare
miaulalala
approved these changes
Jul 2, 2026
skjnldsv
commented
Jul 2, 2026
Co-authored-by: John Molakvoæ <skjnldsv@users.noreply.github.com> Signed-off-by: John Molakvoæ <skjnldsv@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Ok, I'm a bit tired of seeing all those docs bump PRs 🙈
So I decided we could most likely move the cron job into a one PR approach instead of multiple (like those: #15260, #15261, #15262, #15263, #15264 and #15265...)
.github/workflows/build-docs.ymlUnifying the build workflow processes into one workflow file