Conversation
Route release preparation through dev before it can reach the stable main branch.\nRecord and freeze the release dev SHA to prevent unrelated commits entering a tag.\nDocument the promotion gate and the merge-commit topology used by the protected branches.
Aggregate the path-selected PR jobs into one required status check.\nAllow skipped jobs for unaffected paths while failing the aggregate on any failed or cancelled applicable check.\nThis keeps branch protection effective for docs-only and matrix-based pull requests.
Merge the tested stable aggregate check for protected branches.
📚 docs(release): require dev promotion before tags
Allow the PowerShell syntax parser enough startup time on Windows CI runners. The assertion still fails on parser errors; only the test timeout changes.
19 tasks
test(native): extend Windows parser timeout
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
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.
Summary
Promote the verified integration branch
devto the protected stable branchmain. This carries the release-flow documentation and the stable aggregate CI gate introduced by PRs #469 and #470.Scope
Changes
release/<version> → dev → main → tagrelease-promotion process.Required checksaggregate gate so path-skipped CI jobs satisfy the protected-branch policy deterministically.devbranch intomain.User Impact
No product runtime behavior changes. Maintainers and community contributors now have a consistent PR target and a reliable protected-branch gate for docs-only and scoped changes.
Compatibility / Runtime Notes
Data / Security Notes
No credentials, runtime configuration, database data, or release secrets are changed. The existing same-repository
dev → mainsource restriction remains enforced.Risk / Rollback
Risk level: Low
Rollback notes:
Revert this promotion through a new protected
dev → mainPR if the branch model or aggregate-gate policy needs to change.Verification
Commands / evidence:
Screenshots / Recordings
N/A — documentation and CI policy only.
Docs
Docs decision:
docs/release.mdis the canonical release-process reference. No tag or GitHub Release is included in this PR.Related
Refs #469
Refs #470