Re: [Tracker] regarding NEWS file

[Tshepang Lekhonkhobe <tshepang gmail com>]

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

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