aboutsummaryrefslogtreecommitdiff
path: root/.github
diff options
context:
space:
mode:
authorRobert Hensing <roberth@users.noreply.github.com>2023-01-14 11:22:57 +0100
committerRobert Hensing <robert@roberthensing.nl>2023-01-14 11:24:54 +0100
commitdc9c45597950a9eec5630c796af0d2ddb8e608a5 (patch)
tree7850ecd117cd1ab2286054f01e29d941466f675d /.github
parentfd7569393bae53e8203bbbada59bb171ba7a70ed (diff)
Apply suggestions from code review
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
Diffstat (limited to '.github')
-rw-r--r--.github/PULL_REQUEST_TEMPLATE.md23
1 files changed, 13 insertions, 10 deletions
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 1625b9366..6ec1c4b5a 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,22 +1,25 @@
-##### Motivation for the changes
+# Motivation
+<!-- Briefly explain what the change is about and why it is desirable. -->
-<!-- An issue reference or explanation why the change is desirable. -->
-<!-- This speeds up step 1 of the process. -->
+# Context
+<!-- Provide context. Reference open issues if available. -->
+<!-- Non-trivial change: Briefly outline the implementation strategy. -->
+<!-- Invasive change: Discuss alternative designs or approaches you considered. -->
+<!-- Large change: Provide instructions to reviewers how to read the diff. -->
-
-
-##### Checklist for maintainers
+# Checklist for maintainers
<!-- Contributors: please leave this as is -->
<!-- Maintainers: tick if completed or explain if not relevant -->
- - [ ] is the idea good? has it been discussed by the Nix team?
+ - [ ] agreed on idea
+ - [ ] agreed on implementation strategy
- [ ] unit tests
- [ ] functional tests (`tests/**.sh`)
- [ ] documentation in the manual
- - [ ] documentation in the code (if necessary; ideally code is already clear)
- - [ ] documentation in the commit message (why was this change made? for future reference when maintaining the code)
- - [ ] documentation in the changelog (to announce features and fixes to existing users who might have to do something to finally solve their problem, and to summarize the development history)
+ - [ ] code and comments are self-explanatory
+ - [ ] commit message explains why the change was made
+ - [ ] new feature or bug fix: updated release notes