On Tue, Apr 3, 2012 at 9:24 PM, Tim Starling <tstarl...@wikimedia.org> wrote: > On 04/04/12 10:31, Daniel Friesen wrote: >> We have a policy of restricting the length of the first line. Since >> it's used by gerrit as email subjects. >> So as a result when I write the first line of a git commit I >> inevitably leave out critical information. >> So the first line of a commit misses out information that if I had a >> RELEASE-NOTES line to write would be in there. >> >> Also, I've noticed that a decent portion of my commits are small >> backend stuff or modifications. Stuff which have little business being >> inside RELEASE-NOTES. >> Frankly if we do it that way RELEASE-NOTES becomes little more than a >> commit log, which is a lot less valuable than the RELEASE-NOTES we >> currently have. > > I agree with this. Usually I target commit messages at developers and > release notes messages at users. Sometimes that means that the two > texts have nothing in common at all. > > I think the release notes could go further down in the commit message, > perhaps with a footer style similar to Gerrit's Change-Id, for example: > > Refactored Foo.php, splitting animal classes from vegetable classes > > * Used closures for EVERYTHING > * (bug 98765) Fixed a spelling error in a CSS class name > > Release-Notes: (bug 98765) Renamed CSS class .foo-arbitary to > .foo-arbitrary >
+1 -Chad _______________________________________________ Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l