Re: [Tracker] regarding NEWS file



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



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]