aboutsummaryrefslogtreecommitdiff
path: root/maintainers
diff options
context:
space:
mode:
authorValentin Gagarin <valentin.gagarin@tweag.io>2023-01-11 09:39:24 +0100
committerValentin Gagarin <valentin.gagarin@tweag.io>2023-03-28 11:51:57 +0200
commit6c651599b0fa6c049e5044608fcde1daefb17142 (patch)
tree2caf9a53bb778b95b6823675776ef11b87b5dc4e /maintainers
parent56dc6ed8410510033b835d48b3bd22766e8349a0 (diff)
review process: all PRs must be triaged
in order to make the development process more transparent for everyone, all pull requests should go through the triage process before getting merged. this ensures that all team members are aware of what is going on, and that rationale for decisions is kept track of in the meeting notes for posterity. (ideally all that should go into the commit history, but this is a more invasive process change that needs further deliberation.) having all team members take at least a brief but conscious look at each change may also help with keeping our quality standards, as more reviewers are more likely to remind each other of our shared values.
Diffstat (limited to 'maintainers')
-rw-r--r--maintainers/README.md4
1 files changed, 3 insertions, 1 deletions
diff --git a/maintainers/README.md b/maintainers/README.md
index 476a5f51e..95f58acaa 100644
--- a/maintainers/README.md
+++ b/maintainers/README.md
@@ -56,7 +56,7 @@ Meeting notes are collected on a [collaborative scratchpad](https://pad.lassul.u
The team uses a [GitHub project board](https://github.com/orgs/NixOS/projects/19/views/1) for tracking its work.
-Issues on the board progress through the following states:
+Items on the board progress through the following states:
- No Status
@@ -79,6 +79,8 @@ Issues on the board progress through the following states:
If there is disagreement on the general idea behind an issue or pull request, it is moved to _To discuss_, otherwise to _In review_.
+ To ensure process quality and reliability, all pull requests must be triaged before merging.
+
- To discuss
Pull requests and issues that are deemed important and controversial are discussed by the team during discussion meetings.