Re: [Tracker] regarding NEWS file

[Martyn Russell <martyn imendio com>]

Tshepang Lekhonkhobe wrote:
> On Wed, Feb 11, 2009 at 12:17 PM, Martyn Russell <martyn imendio com> 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.

--
Regards,
Martyn