Git Essentials ??? Second Edition - Second Edition

Writing a meaningful subject

The subject of a commit is the most important part: its role is to make clear what the commit contains. Avoid technical details of other things - a common developer can understand opening the code, and focus on the big picture: remember that every commit is a sentence on the repository history. So, wear the hat of the changelog reader and try to write the most convenient sentence for him, not for you: use present tense, and write a 50 chars max sentence.

A good subject is one like this: "Add the newsletter signup in homepage".

As you can see, I used the imperative past tense and, more importantly, I didn't say what I had done, but what the feature does: it adds a newsletter signup box to my website.

The 50-char ...