On Fri, May 17, 2013 at 6:50 AM, W. Trevor King <wking(a)tremily.us> wrote:
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 ;).
Agreed on summary, but that != ChangeLog.
Luis