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 packages. -- "You grabbed my hand and we fell into it, like a daydream - or a fever."
Attachment:
pgpe2NunkeWRj.pgp
Description: PGP signature