Hey there!
So, recently I started in a new company where the process of reviewing code is not a critical part of the workflow, so I am developing a template for our pull request, in an atempt to improve our codebase and the process of reviewing a new change.
Why did I do this? Was it really necessary?
YES. I think a pull request should be a kind of documentation where you explain the context of your changes to your colleagues, not explaining the code, but explaining the business logic behind this change, why are you doing this work?
So I created a template for this, and set it as the default template every time you want to create a new PR.
Here is the template:
Add the template as default in Github
And if you use Github, putting this as a PR template is super easy, you just need to create a file called pull_request_template.md
and put it in the root of your project, or inside the .github
folder.
You can see this with more details here: https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository
That's all, I hope it can be helpful for you 🥳