How to write Git Commit Message
Good “git commit message” serves as a log that tells WHY and WHEN we made changes. Whilst diff shows only WHAT. A useful message is comprised of:
Concise (50 chars) imperative subject with reference to issue/change #
One blank line between subject and body
Body explains WHAT WHY HOW and wraps at 72 chars.
[KERNEL-003] Update Network Module to Support Wifi Nowadays people use WIFI. For this reason, it is unacceptable for kernel not to support Wifi. Add a new subcomponent for network module that provides the following features: - listen to Wifi driver - save logs
One liner is acceptable if the change is simple and straightforward
In shared repository model, PR triggers automatic test and build on CI and review request. The guideline to writing good commit message also applies to writing good PR title and body.
Bump Major when API changes
Bump Minor when adding new functionality without breaking API
Bump Path for bug fixes.
Review commit message as well as the actual code.
Don’t forget to praise
If in doubt Question rather than Judge
Look at the whole design and code surrounding the change, not just the change itself
There are many ways to have things done – respect the author