Skip to content
Logo Theodo

Increase team productivity with Github templates

Thibault Coudray3 min read

GitHub released in February a new functionality that the community has been asking for years. It’s now possible to set up templates for issues and pull requests!

How does it work?

Implementing these new templates is quite easy.

Step One:

Create a .github folder in the root directory of your project.

cd ../path/to/your/project
mkdir .github

Step Two:

Add a PULL_REQUEST_TEMPLATE.md or/and ISSUE_TEMPLATE.md in the .github folder you’ve just created.

cd .github
vim PULL_REQUEST_TEMPLATE.md
# your template for PRs
vim ISSUE_TEMPLATE.md
# your template for issues

Here is an example of what your pull request template might look like:

## Link to the user story
[User Story 3](https://trello.com/path/to/my/board)

## Screenshots

## Types of changes

- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change

## Maintainability & Security

- [ ] The feature is tested
- [ ] My PR complies with the security checklist
- [ ] The code coverage is higher than 80%

## Coding Style
- [ ] Functions are no longer than 30 lines
- [ ] Each function is only performing one task
- [ ] Files are no longer than 200 lines

<!-- You can add as many items as you like. Your imagination is the limit. -->


If you feel like you can get easily bored by this task, you might want to use this bookgame 😉.

Step Three:

Commit, push and that’s it, you are ready to go 😃. Now each time a contributor will open a pull request or an issue on your project, the body of their request will be pre-filled with the template you’ve created.

Why templates have more impact than you think

It is so easy to implement, that it seems to be a little thing. It can actually make both your life and those of your contributors easier:

At Theodo we are quite fond of this new feature since it helps us constantly improving the quality of our work. For instance, we’ve noticed that functionalities have often been refused by our product owner for the same reason (e.g. we didn’t follow the wireframe). We added an item to the checklist prevent this reason from appearing again. In our case, it was “I have checked that the functionality complies with the wireframes”. Thanks to the template we never forget to follow the wireframe thus never waste the time of our product owner with this problem anymore. That’s why templates are a good way to increase the value we bring to our clients.

Liked this article?