-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Thu, Jan 22, 2009 at 09:54:36AM +0100, Simon Schampijer wrote: >So the command for sugar for this release would be [...]: > >git log v0.83.4..v0.83.5 --no-merges | git-shortlog > >That will encourage people to write nice commit messages :) I would >suggest to put up some guidelines (no rules), so a reader can more >easily parse them. For example: > >- ticket number always at the beginning of the commit message >- Start message with a capital letter >- For typo fixes use: _Typo >- For pylint fixes use: _Pylint
Use the recommended style as mentioned in Git documentation somewhere: First line a summary of at most 40 chars, then empty line, then optional detailed commit message (which is stripped by git-shortlog). Also, I'd suggest mentioning ticket numbers at end instead, in the style used by Debian. Example: Fix foobar -> barbaz. Closes: SL#1234, OLPC#1235. The logic is to always prepend "Closes: " and then either "SL#" or "#" for each comma-separated ticket closed, or prepend "OLPC#" for tickets closed at the laptop.org bugtracker. - Jonas - -- * Jonas Smedegaard - idealist og Internet-arkitekt * Tlf.: +45 40843136 Website: http://dr.jones.dk/ [x] quote me freely [ ] ask before reusing [ ] keep private -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (GNU/Linux) iEYEARECAAYFAkl4irQACgkQn7DbMsAkQLgCDQCbBObD5vCNDLrGX3HNLNK1RvFg vokAniZd0hz/KXxZ2JhUf1Fr8s6me++e =4VCG -----END PGP SIGNATURE----- _______________________________________________ IAEP -- It's An Education Project (not a laptop project!) [email protected] http://lists.sugarlabs.org/listinfo/iaep
