diff options
author | Robert Hensing <roberth@users.noreply.github.com> | 2023-01-14 11:22:57 +0100 |
---|---|---|
committer | Robert Hensing <robert@roberthensing.nl> | 2023-01-14 11:24:54 +0100 |
commit | dc9c45597950a9eec5630c796af0d2ddb8e608a5 (patch) | |
tree | 7850ecd117cd1ab2286054f01e29d941466f675d /.github | |
parent | fd7569393bae53e8203bbbada59bb171ba7a70ed (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.md | 23 |
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 |