Commit Message Conventions
Last updated
Last updated
Writing good commit messages helps you and your teammates to track changes more effectively. The commit message should provide a good summary of the changes made.
Be specific
- bug fix
- refactor
- Add null check to input parser
- Refactor navbar component for better readability
If you find it difficult to summarise your changes, consider splitting them into multiple commits. Try to group related changes together in commits for easier compartmentalisation.
While you may enter anything in the commit message, we strongly recommend sticking to some convention when creating your commit messages.
A common convention is:
First line: 80-character title, phrased imperatively
Then if your change is complex, elaborate on the change in prose.
One bonus of this convention is that branches can be named similarly, e.g. (feat/add-button)
.
Another convention is :
You may also refer to CS2103/T (Software Engineering)'s conventions for naming: