Skip to content

Document how pull requests are reviewed and merged - #558

Merged
andrew merged 1 commit into
git-pkgs:mainfrom
montehurd:contributing-review-rules
Oct 23, 2026
Merged

andrew merged 1 commit into
git-pkgs:mainfrom
montehurd:contributing-review-rules

Conversation

@montehurd

Copy link
Copy Markdown
Contributor

Adds a "Reviewing and Merging" section to CONTRIBUTING.md, next to the Releases section from #544. It records the rules from @andrew's proposal in #514 (comment), which @simonchrz +1'd.

Two places where I had to choose wording:

  • The proposal says a "request changes" review blocks a merge "until that's resolved". I wrote "until that reviewer approves or withdraws the review", so one maintainer can't dismiss another's block. Correct me if you meant something looser.
  • "For a release before it goes" became "in at least one release before the one that removes it", since patch releases are now monthly and removals ship in a minor.

Record the rules agreed in git-pkgs#514: one approval from a maintainer other
than the author plus green CI, a "request changes" review blocks the
merge, and bigger changes start with an issue.

@andrew andrew left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@andrew
andrew merged commit 6189753 into git-pkgs:main Oct 23, 2026
6 checks passed
@andrew

andrew commented Oct 23, 2026

Copy link
Copy Markdown
Contributor

Thanks!

@montehurd
montehurd deleted the contributing-review-rules branch October 26, 2026 23:15
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.

2 participants