Skip to content

Instantly share code, notes, and snippets.

@zanbaldwin
Last active December 13, 2024 10:20
Show Gist options
  • Save zanbaldwin/c486f57cd9b2f4e995fec33f4ed8f87b to your computer and use it in GitHub Desktop.
Save zanbaldwin/c486f57cd9b2f4e995fec33f4ed8f87b to your computer and use it in GitHub Desktop.
Unnecessarily complex pull request template.

Either put the Jira/Issue number in the title, or exclaim "the PM gods hath forsaken me!"

Blocked by (these merge requests need to be reviewed and merged first):

Overall Category:

  • πŸ› bugfix (semantic PATCH version bump)
  • ✨ feature (semantic MINOR version dump)
  • πŸ’„ style (styling or template changes)
  • 🚨 test (adding, improving or correcting tests)
  • 🧹 chore (other and/or automated changes)
  • πŸ—£ lang (changes to text content or languages translations)
  • πŸ”¨ refactor (code improvements that don't change functionality)
  • πŸ“¦ build (changes that affect the build system or external dependencies)
  • πŸ“š docs (goal-oriented guides, learning-orntd tutorials, information-orntd references, etc)
  • πŸ€– ci (changes to the CI/CD pipeline or deployment process)
  • ⚑ perf (performance improvements or debugging investigations)
  • βͺ revert (undoing previously committed changes)

Description: a general summary of the merge request and its changes (double points if it's written as a poem).

What type of peer review is being requested?

  • Code review
  • Manual testing
  • Data integrity testing
  • Content/spelling/grammar/translations review
  • Help with documentation and/or technical writing
  • πŸ’‰ I crave the validation of your feedback (constructive criticism, pretty please)

Review Notes

Add some notes to the reviewer telling them about the hardships you've gone through, and convince them why your merge request is the bee's knees.

Testing Notes

  • What criteria/state does the reviewer need to be in to start testing?
  • How should the reviewer navigate to the part that needs testing?
  • What should the reviewer be looking out for?
  • What actions does the reviewer need to perform?
  • How would the reviewer verify the changes they're seeing are correct?

Have tests been added to the merge request?

  • Yes, changes are covered by tests
  • Test coverage is lacking, and I would like assistance from a fresh set of eyes
  • No, tests are not needed

Build System

  • Do dependencies need to be updated? composer install, npm i, etc.
  • Do assets need to be rebuilt? How?

Database Changes

  • Do database migrations need to be run? (make migrate)
  • Are there any new data fixtures?
  • Anything else database-related?

Documentation Updates

  • README.md
  • ONBOARDING.md
  • Not yet, but this merge request is a ideal candidate to be documented
  • Separate merge request:

Notes

Post-merge: Any notes regarding anything after the merge request is merged, such as: deployment, or notifying project lead / developers / clients?

Out of scope: Did you have any thoughts or ideas that are out of scope for this particular merge request? Should they be turned into issues, brought up as discussion points for the team, etc?

Bonus: Using a Gif, describe how this merge request made you feel.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment