On Fri, May 17, 2013 at 06:42:28AM -0700, Luis R. Rodriguez wrote:
ChangeLogs are for old foggies. Its year 2013, git is being used and
you should be able to git log v0.2.1..v0.3.0.
I think the idea is to give users a quick overview of the high-level
changes (the stuff that users are likely to care about, filtering out
the stuff that only developers are likely to care about). For
example, I wouldn't put 840419b (Fix line lengths, 2013-05-16) in my
changelog ;).
Git does this sort of thing with release notes [1], but for some
projects I just summarize changes in the commit message [2]. Some
sort of summary is useful, if only because posting it to the mailing
list helps keep people interested ;).
Cheers,
Trevor
[1]:
http://git.kernel.org/cgit/git/git.git/tree/Documentation/RelNotes
[2]:
https://github.com/wking/quizzer/commit/63706636f951ae27d1e431cc7e90833c0...
--
This email may be signed or encrypted with GnuPG (
http://www.gnupg.org).
For more information, see
http://en.wikipedia.org/wiki/Pretty_Good_Privacy