From f76ca38e95cee08ff80d3308ae4e08d0c4f4388f Mon Sep 17 00:00:00 2001 From: Tuncer Ayaz Date: Wed, 25 Aug 2010 23:29:17 +0200 Subject: Document how to write good commit messages Based on http://gist.github.com/539516. --- HACKING | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/HACKING b/HACKING index e1c5288..6df34c5 100644 --- a/HACKING +++ b/HACKING @@ -9,3 +9,42 @@ you to save this as part of custom-set-variables: You can also tell Emacs to ignore file variables: (setq enable-local-variables nil enable-local-eval nil) + + +Writing Commit Messages +======================= + + One line summary (< 50 characters) + + Longer description (wrap at 72 characters) + +Summary +------- + +* Less than 50 characters + +* What was changed + +* Imperative present tense (fix, add, change) + + Fix bug 42 + Add 'foobar' command + Change default timeout to 42 + +* No period + +Description +----------- + +* Wrap at 72 characters + +* Why, explain intention and implementation approach + +* Present tense + +Atomicity +--------- + +* Break up logical changes + +* Make whitespace changes separately -- cgit v1.1