Am Montag, 24. August 2009 02:55:14 schrieb Stephen Swaney: > On Mon, Aug 24, 2009 at 12:40:56AM +0200, Christian Ohm wrote: > > On Sunday, 23 August 2009 at 23:40, Per Inge Mathisen wrote: > > > I like current format. It gives superb traceability of everything in > > > the changelog, and looks really "correct". If it is a PITA to maintain > > > for people, I am willing to do it. If you want to use the ChangeLog in > > > official postings, just sed remove everything inside parentheses first > > > to make it look better.> > > > > I agree with Dennis that the Changelog should give a good overview of the > > user-relevant changes, and the current "copy the svn log the day before a > > release" approach doesn't do a good job of that. > > The Changelog should be detailed information for developers - exactly > what is different in the code from before. > > Users only care about visible changes. For them, something like GNU's > NEWS or Release Notes describes items of interest. > > The Changelog and Release Notes serve two separate functions and have > different audiences. The current Changelog seems fine to me. We never had a changelog-for-developers. Our ChangeLog always was meant to be a changelog-for-users. It was meant to contain user visible changes, with the definition of "user" partly containing mod authors, too.
I never saw sense in having two changelogs, one for the users and one for developers. The latter can look into the svn/git log, and if they cannot, then a svn2cl generated log does not really help them either, without the diffs. --Devu
signature.asc
Description: This is a digitally signed message part.
_______________________________________________ Warzone-dev mailing list [email protected] https://mail.gna.org/listinfo/warzone-dev
