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 -- Tim Starling _______________________________________________ Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l