docs: update COMITTER.md with info about pullapprove.com
This commit is contained in:
parent
77008e35ff
commit
bc1320d926
27
COMMITTER.md
27
COMMITTER.md
|
@ -6,29 +6,16 @@ for details about how we maintain a linear commit history, and the rules for com
|
||||||
As a contributor, just read the instructions in [CONTRIBUTING.md](CONTRIBUTING.md) and send a pull request.
|
As a contributor, just read the instructions in [CONTRIBUTING.md](CONTRIBUTING.md) and send a pull request.
|
||||||
Someone with committer access will do the rest.
|
Someone with committer access will do the rest.
|
||||||
|
|
||||||
## The `PR: merge` label and `presubmit-*` branches
|
# Change approvals
|
||||||
|
|
||||||
We have automated the process for merging pull requests into master. Our goal is to minimize the disruption for
|
Change approvals in our monorepo are managed via [pullapprove.com](https://about.pullapprove.com/) and are configured via the `.pullapprove.yaml` file.
|
||||||
Angular committers and also prevent breakages on master.
|
|
||||||
|
|
||||||
When a PR has `pr_state: LGTM` and is ready to merge, you should add the `pr_action: merge` label.
|
|
||||||
Currently (late 2015), we need to ensure that each PR will cleanly merge into the Google-internal version control,
|
|
||||||
so the caretaker reviews the changes manually.
|
|
||||||
|
|
||||||
After this review, the caretaker adds `zomg_admin: do_merge` which is restricted to admins only.
|
# Merging
|
||||||
A robot running as [mary-poppins](https://github.com/mary-poppins)
|
|
||||||
is notified that the label was added by an authorized person,
|
|
||||||
and will create a new branch in the angular project, using the convention `presubmit-{username}-pr-{number}`.
|
|
||||||
|
|
||||||
(Note: if the automation fails, committers can instead push the commits to a branch following this naming scheme.)
|
Once a change has all the approvals either the last approver or the PR author (if PR author has the project collaborator status) should mark the PR with "PR: merge" label.
|
||||||
|
This signals to the caretaker that the PR should be merged.
|
||||||
|
|
||||||
When a Travis build succeeds for a presubmit branch named following the convention,
|
# Who is the Caretaker?
|
||||||
Travis will re-base the commits, merge to master, and close the PR automatically.
|
|
||||||
|
|
||||||
Finally, after merge `mary-poppins` removes the presubmit branch.
|
See [this explanation](https://twitter.com/IgorMinar/status/799365744806854656).
|
||||||
|
|
||||||
## Administration
|
|
||||||
|
|
||||||
The list of users who can trigger a merge by adding the `zomg_admin: do_merge` label is stored in our appengine app datastore.
|
|
||||||
Edit the contents of the [CoreTeamMember Table](
|
|
||||||
https://console.developers.google.com/project/angular2-automation/datastore/query?queryType=KindQuery&namespace=&kind=CoreTeamMember)
|
|
||||||
|
|
Loading…
Reference in New Issue