On Wed, Feb 11, 2009 at 2:30 PM, Martyn Russell <[email protected]> wrote: > Tshepang Lekhonkhobe wrote: >> >> On Wed, Feb 11, 2009 at 12:17 PM, Martyn Russell <[email protected]> >> wrote: >>> >>> Tshepang Lekhonkhobe wrote: >>> The NEWS file can have whatever you want in it. In my other projects, I >>> tend >>> to put the things that have changed. This includes: >>> >>> - Bugs >>> - Translations >>> - Manual translations >>> - Features >> >> I feel that features and changes are the only things that should be >> documented in there. >> >>> People will read bugs if they know of a bug they have and want to see if >>> it >>> was fixed. Of course, some people might just be interested. >> >> I feel that if people were interested in specific bugs, they'd >> actually subscribe to them. > > I don't subscribe to GTK+ bugs at all, but when a release comes out, I look > through the list because I am interested to know what was fixed. > > All the projects I have worked on in the past have done that. That doesn't > make it *the* way to do it of course. > >>> This is totally up to the maintainer(s). I for one, like to see >>> everything >>> that changed, otherwise the NEWS is a bit fuzzy, it only includes some of >>> what changed. >> >> I feel that NEWS should have your newsworthy kind of stuff, and that >> 'everything' should go to the Changelog. > > No. The ChangeLog is an incredibly verbose way of seeing what is happening. > You need varying levels of verbosity on things like this. Some people don't > have time to read every ChangeLog item, but they might have time to go over > a list of bugs every month when a release comes out. I certainly wouldn't > ever think of reading the GTK+ ChangeLog unless I was actively contributing > to the project.
yeah it's just a matter of preference... I will now rest :-) I wish there was a standard though because sometimes you find NEWS material in ChangeLog and the NEWS file itself empty, or worse, no NEWS or ChangeLog. -- my place on the web: floss-and-misc.blogspot.com _______________________________________________ tracker-list mailing list [email protected] http://mail.gnome.org/mailman/listinfo/tracker-list
