DEV Community

Cover image for Guideline: Commit messages
Pierre-Henry Soria ✨
Pierre-Henry Soria ✨

Posted on • Updated on

Guideline: Commit messages

Here is the markdown with typos fixed:

The 2 most important guidelines when committing your code

Commit messages πŸ“

Commit messages play a big role in the understanding of every change. They should be in present tense, short, clear and explicit.

They should clearly say what happened as well as the reason/motivation behind the change.

Ask yourself, β€œWhat are the changes done for?” In other words, β€œWhy you did what you did?” - In short, it is the explanation that we don't necessarily see in the code diff of the commit.

Additionally, add the ticket ID at the beginning of your commit message. Sometimes, we need to know the reason why a piece of code has been changed and need to dig into the ticket to have a full understanding of the feature requirements.


Git commits 🎨

βœ… Each commit should be small and fix only one thing per commit, not more. Following this important rule, if your commit message contains the word and or +, that means you are trying to commit multiple changes in one commit and you shouldn't ❌

This rule is not just there to be nice. When you need to git revert or cherry-pick a commit from your git history, the fact that one commit only contains one specific update really helps.

Top comments (1)

Collapse
 
pierre profile image
Pierre-Henry Soria ✨

Feedback/Thoughts? I can't wait to hear from you. I read every single comment! 😊