Skip to content

ci: point the docs deploy workflow at develop (#408) - #410

Merged
Paulo Lacerda (placerda) merged 1 commit into
mainfrom
chore/deploy-docs-workflow-main
Aug 9, 2026
Merged

ci: point the docs deploy workflow at develop (#408)#410
Paulo Lacerda (placerda) merged 1 commit into
mainfrom
chore/deploy-docs-workflow-main

Conversation

@placerda

Copy link
Copy Markdown
Contributor

Companion to #409, which makes develop the single source for the published documentation site.

Why this needs to target main directly

GitHub Actions resolves workflow files for non-push events from the default branch only. The release: published trigger in deploy-docs.yml therefore runs whatever version of that file is on main, regardless of what develop says.

main currently holds the version that checks out the orphan docs branch. If #409 merged on its own, the next published release would fire that stale copy and republish the old docs tree over the new site. This closes that window.

What it changes on main

Nothing behavioural. The push trigger in this file only matches develop, so pushing to main still matches no trigger here. The file is identical to the one #409 puts on develop.

Merge order

Either order works, but merging this one first is safer: it means there is no point in time where main can undo #409.

Refs #408

GitHub Actions resolves workflows for non-`push` events from the default
branch only, so the `release: published` trigger runs whatever version of
this file is on `main`. Without this commit that trigger would keep
checking out the orphan `docs` branch after #409 lands, and a release
would republish the old tree over the new one.

This carries the same file that #409 puts on `develop`. It changes no
behaviour on `main` itself: the `push` trigger only matches `develop`, so
pushing to `main` still matches nothing here.
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