[-1] I'm not a committer so I don't get a vote, but FWIW I've always preferred human-managed change logs, since that means a human being is highlighting the more important changes, new or changed APIs, features, etc. whereas the machine-generated ones force me to slog through *all* of the changes.
Yes, it does require some overhead but it's very helpful for co-developers. Ichiro On Sat, Jan 26, 2013 at 11:55 PM, Harry Metske <[email protected]> wrote: > -0.5 > > I have always found this Changelog a very convenient mechanism of searching > for "what has changed when in what version". > You have it one file, easily searchable and scrollable. > The overhead is minimal, always cut/paste the Changelog update to the > commit log. > I agree that mentioned links provide all information (and more), but not so > easy to search, you always have to click a hundred times before you find > what you want. > > kind regards, > Harry > > > On 25 January 2013 03:29, Glen Mazza <[email protected]> wrote: > >> Hi team, we have a "ChangeLog" file in the root folder that is apparently >> (?) updated whenever someone makes a commit. I don't see a need for it, >> and none of the other Apache projects I'm aware of bothers with such a file >> -- it's annoying needing to update it and it just seems to be unnecessary >> overhead. Can we get rid of it? >> >> So long as you make comments when you commit, here is a 100.0% >> authoritative and chronological list of all commits made and what they >> involve: >> http://mail-archives.apache.**org/mod_mbox/incubator-** >> jspwiki-commits/201301.mbox/**browser<http://mail-archives.apache.org/mod_mbox/incubator-jspwiki-commits/201301.mbox/browser> >> >> And of course the SVN repository details the changes made to each specific >> file fully and accurately: >> http://svn.apache.org/viewvc/**incubator/jspwiki/trunk/src/** >> webdocs/Error.jsp?view=log<http://svn.apache.org/viewvc/incubator/jspwiki/trunk/src/webdocs/Error.jsp?view=log> >> >> Finally, JIRA nicely provides us a list of commits per release: >> https://issues.apache.org/**jira/browse/JSPWIKI#** >> selectedTab=com.atlassian.**jira.plugin.system.project%**3Achangelog-panel<https://issues.apache.org/jira/browse/JSPWIKI#selectedTab=com.atlassian.jira.plugin.system.project%3Achangelog-panel> >> >> That should be good enough for us. WDYT? >> >> Regards, >> Glen >>
