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

Re: NEWS.Debian files

On Mon, Jul 08, 2002 at 02:54:04PM -0400, Matt Zimmerman wrote:

> This sounds exactly backwards.  The NEWS file should give brief, important
> notices,

This isn't what the notes that people are looking to replace (at least
the ones I notice) are being used for - they're being used for
relatively large notices.  They are large because they tend to involve
not only a description of the change itself but also a description of
what the impact is for users and what actions they should take.

>          while the changelog verbosely describes changes.

Normally a changelog is verbose because it describes many small changes
(normally briefly) rather than because each of the changes is described
in any great detail.  This is rather different to what's described above
where a different audience with very different needs is being addressed.
Mixing the two styles of documentation in one place seems ugly - I feel
there are good reasons why they are generally separated in upstream

"You grabbed my hand and we fell into it, like a daydream - or a fever."

Attachment: pgpskQYBguqWl.pgp
Description: PGP signature

Reply to: