Skip to content

Commit bdc8758

Browse files
Carles CufiChromeos LUCI
authored andcommitted
doc: contribute: Extend Reviewer Expectations with additional rules
This change was triggered by a review comment linked below: zephyrproject-rtos#83117 (comment) It extends the current Reviewer Expectations with additional rules agreed upon by multiple Zephyr contributors in order to simplify and standardize the decision-making process during PR reviews. (cherry picked from commit ea4e46d) Original-Signed-off-by: Carles Cufi <[email protected]> Original-Signed-off-by: Anas Nashif <[email protected]> GitOrigin-RevId: ea4e46d Cr-Build-Id: 8725452993329915921 Cr-Build-Url: https://cr-buildbucket.appspot.com/build/8725452993329915921 Copybot-Job-Name: zephyr-main-copybot-downstream Change-Id: I7612209e4dfb9d453088919383d32fcd422d5b23 Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/third_party/zephyr/+/6183339 Tested-by: ChromeOS Prod (Robot) <[email protected]> Reviewed-by: Jonathon Murphy <[email protected]> Commit-Queue: Jonathon Murphy <[email protected]>
1 parent 2189546 commit bdc8758

File tree

1 file changed

+19
-2
lines changed

1 file changed

+19
-2
lines changed

doc/contribute/contributor_expectations.rst

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -368,10 +368,27 @@ Reviewer Expectations
368368
they address all non-blocking comments. PR authors should acknowledge every
369369
review comment in some way, even if it's just with an emoticon.
370370

371-
- Reviewers shall be *clear* and *concise* what changes they are requesting when the
371+
- Style changes that the reviewer disagrees with but that are not documented as
372+
part of the project can be pointed out as non-blocking, but cannot constitute
373+
a reason for a request for changes. The reviewer can optionally correct any
374+
potential inconsistencies in the tree, document the new guidelines or rules,
375+
and then enforce them as part of the review.
376+
377+
- Whenever requesting style related changes, reviewers should be able to point
378+
out the corresponding guideline, rule or rationale in the project's
379+
documentation. This does not apply to certain types of requests for changes,
380+
notably those specific to the changes being submitted (e.g. the use of a
381+
particular data structure or the choice of locking primitives).
382+
383+
- Reviewers shall be *clear* about what changes they are requesting when the
372384
"Request Changes" option is used. Requested changes shall be in the scope of
373385
the PR in question and following the contribution and style guidelines of the
374-
project.
386+
project. Furthermore, reviewers must be able to point back to the exact issues
387+
in the PR that triggered a request for changes.
388+
389+
- Reviewers should not request changes for issues which are automatically
390+
caught by CI, as this causes the pull request to remain blocked even after CI
391+
failures have been addressed and may unnecessarily delay it from being merged.
375392

376393
- Reviewers shall not close a PR due to technical or structural disagreement.
377394
If requested changes cannot be resolved within the review process, the

0 commit comments

Comments
 (0)