summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAsh McKenzie <amckenzie@gitlab.com>2019-09-06 02:49:54 +0000
committerAsh McKenzie <amckenzie@gitlab.com>2019-09-06 13:09:50 +1000
commit7989ed1eb27aad786888674778c9ad308e5f3493 (patch)
tree2f12947d4d8a84429cb5c57120787f179c5c564e
parent7ba4ffec7e3bc7845dfd52b2cdd213d046940144 (diff)
downloadgitlab-ce-ashmckenzie/add-reviewer-responsibility-section-doc.tar.gz
Add 'responsibility of the reviewer' sectionashmckenzie/add-reviewer-responsibility-section-doc
-rw-r--r--doc/development/code_review.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/development/code_review.md b/doc/development/code_review.md
index bcfc0734c06..732105f7cd2 100644
--- a/doc/development/code_review.md
+++ b/doc/development/code_review.md
@@ -127,6 +127,26 @@ through Slack). If you can't assign a merge request, `@` mentioning a maintainer
This
[saves reviewers time and helps authors catch mistakes earlier](https://www.ibm.com/developerworks/rational/library/11-proven-practices-for-peer-review/index.html#__RefHeading__97_174136755).
+### The responsibility of the reviewer
+
+Reviewers are encouraged to look at the following:
+
+- Merge request title and description are accurate
+- Merge request description checkboxes are ticked as approrpriate
+- Documentation label applied if there are docs changes
+- Correct milestone is applied (if applicable)
+- Ensure the merge request branch is not too far behind the target branch
+(ideally less than 100 commits)
+- Ensure all CI jobs are paassing
+- Examine any Danger bot warnings or errors
+- Examing any code degradations
+
+When a reviewer is happy with the state of the merge request, they should:
+
+- Click the Approve button.
+- Advise the merge request author they have reviewed and approved.
+- Assign to the nominated maintainer.
+
### The responsibility of the maintainer
Maintainers are responsible for the overall health, quality, and consistency of