Skip to content

Commit

Permalink
Merge branch '5' into 6
Browse files Browse the repository at this point in the history
  • Loading branch information
github-actions[bot] committed Aug 14, 2024
2 parents bdef0ca + 8a92785 commit fbc67af
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 13 deletions.
5 changes: 2 additions & 3 deletions en/10_Contributing/08_Triage_Resources.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,9 +42,8 @@ How to do it
1. Follow the [merge checklist](#merge-checklist). You may even post it straight on GitHub so the contributor sees the PR progress
1. If changes are required or you need some additional context, ask specific questions and for specific changes. Then move the PR to the "awaiting response" column. Keep it assigned to you.
1. If the author doesn't respond for several weeks you may choose take the PR over and push it forward yourself by adding your own commits to their branch - in that case, you become the developer and someone else will need to review the pull request when you are done. Otherwise, it’s fine to close the PR if there has been no response and you don't want to take it over yourself.
1. Once you are happy with the pull request, approve it. If you need a second approval, move it to the "needs second approval" column and unassign yourself.

Pull requests in the "needs second approval" column should be reviewed following the same steps as above - but after approving the pull request (as the second approver) you can merge it.
1. Approve the pull request once you are happy with it, then move it to the "ready to merge" column and unassign yourself.
1. Ping `@silverstripe/core-team` and `@silverstripe/contributing-committers` so the Core Committers and CMS Squad know it's ready to merge.

### Merge checklist

Expand Down
17 changes: 7 additions & 10 deletions en/12_Project_Governance/03_Maintainer_Guidelines.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,8 @@ The following table outlines the general responsibilities and privileges attribu
|Responsibilities/privileges|Contribution Refiners|Peer Reviewers|CMS Squad Members|Core Committers|
|---|---|---|---|---|
|Triage issues|x|x|x|x|
|Review pull requests|x|x|x|x|
|Approve pull requests| |x|x|x|
|Merge PRs without requiring additional maintainer approval| | |x|x|
|Review pull requests| |x|x|x|
|Merge pull requests| | |x|x|
|Administer repositories| | | |x|

### Core committers
Expand Down Expand Up @@ -66,13 +65,11 @@ While anyone in the community can review a pull request, only reviews from maint
- If another reviewer feels confident, they can offer to review it instead
- Escalate pull requests to Core Committers if the contributor is rude/argumentative/hard to deal with
- If you feel confident doing so, politely request the contributor behave in accordance with our [code of conduct](./code_of_conduct), and close the pull request if they refuse to do so
- After two maintainers have approved the pull request, merge it
- The person who merges the PR can be one of the two approving reviewers
- The person who merges the PR must also understand and approve the changes
- The person who contributed the PR must not be included as one of the two approving reviewers
- If you don't feel confident clicking merge, ask for a second opinion. Don’t approve the pull request if you wouldn’t feel confident merging it - instead, say where you got to with it (e.g. tested, worked well locally, couldn’t find any problems but want another opinion) and get another reviewer to check it
- Make sure Core Committers and CMS Squad are aware when a pull request has been approved and is ready to be merged
- Don’t approve the pull request if you wouldn’t feel confident merging it - instead, say where you got to with it (e.g. tested, worked well locally, couldn’t find any problems but want another opinion) and get another reviewer to check it
- If no other reviewer feels confident about it, but it seems like it’s probably a good change in general, escalate to Core Committers
- If at any point there is a disagreement between reviewers that seems unresolvable, escalate the discussion to Core Committers.
- If any pull requests seem to be fixing a security issue, immediately notify the CMS Squad and Core Committers

If a reviewer doesn’t review any pull requests in a 12 month period, a member of the Core Committers or the Silverstripe CMS Product Owner will reach out and ask if they want to continue being a reviewer. If they don’t respond within a month (or they respond saying they don’t want to be a reviewer anymore), their permissions will be revoked and they will be removed from the team.

Expand Down Expand Up @@ -181,12 +178,12 @@ First and foremost rule of a maintainer is to collaborate with other maintainers
- Treat issues according to our [issue guidelines](/contributing/issues_and_bugs/), and use the [triage resources](/contributing/triage_resources/)
- Don't commit directly to existing branches, raise pull requests instead
- Use forks to create feature branches for pull requests
- Only merge code you have tested and fully understand. If in doubt, ask for a second opinion.
- Only approve and merge code you have tested and fully understand. If in doubt, ask for a second opinion.
- Follow the [Supported Modules Standard](https://www.silverstripe.org/software/addons/supported-modules-definition/)
- Ensure contributions have appropriate [test coverage](/developer_guides/testing/), are documented, and adhere to our [coding conventions](/getting_started/coding_conventions/)
- If the contributor has trouble adding tests or documentation, you can raise your own pull requests that adds tests or documentation for the change and then merge their change
- Keep the codebase stable at all times (check our [release process](/contributing/release_process/))
- If there are CI failures which are unrelated to the changes a given pull request, you can merge the pull request if all relevant tests are being run and passing
- If there are CI failures which are unrelated to the changes a given pull request, you can approve and merge the pull request if all relevant tests are being run and passing
- Changes must be merged into the appropriate branches and follow semantic versioning (see [picking the right version](/contributing/code/#picking-the-right-version))
- Be inclusive. Ensure a wide range of Silverstripe CMS developers can obtain an understanding of your code and docs, and you're not the only one who can maintain it.
- Avoid `git push --force`, and be careful with your git remotes (no accidental pushes)
Expand Down

0 comments on commit fbc67af

Please sign in to comment.