Repository navigation
docs: close gaps in the PR/release workflow writeup - #5
Merged
Merged
Conversation
- Release: the v* tag must point at the merged main HEAD — with a squash merge the release branch's local commit is not in main's history, and immutable tags cannot be moved without ruleset surgery. Spell out 'git checkout main && git pull --ff-only'. - Conventions/CONTRIBUTING: no approvals are required to merge (required_approving_review_count: 0, solo project). - Conventions/CONTRIBUTING: write PR titles as conventional-commit subjects — a squash merge makes the title the commit subject that scripts/changelog.ts reads. - Conventions: refresh dependabot PR branches with '@dependabot rebase'; 'gh pr update-branch' fails on workflow-touching PRs without the OAuth workflow scope (bit us 2026-10-04).
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
1 participant
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.
对 AGENTS.md / CONTRIBUTING.md 的 PR 流程与发布流程描述做审计后的修补，4 处：
v*tag 必须打在 merged main HEAD 上——squash 合并时 release 分支的本地 commit 不在 main 历史里，而不可变 tag 打错无法移动。同时补全git checkout main && git pull --ff-only。required_approving_review_count: 0(solo 项目），绿了即可合，不用等 reviewer。scripts/changelog.ts据此生成草稿，AGENTS.md 与 CONTRIBUTING.md 同步强调。@dependabot rebase评论；gh pr update-branch对改了 workflow 的 PR 会因 OAuth 缺workflowscope 失败（2026-10-04 实测）。纯文档改动。