[Python-Dev] Doc/whatsnew/* v. Misc/NEWS (original) (raw)

Martin v. L�wis martin@v.loewis.de
03 Dec 2002 18:42:19 +0100

Michael Hudson <mwh@python.net> writes:

I'd have said yes: Misc/NEWS is for "developers" and whatsnew is for "users", although this is blatantly a bogus categorization.

NEWS items are brief to the point of curtness, whatsnew has more explanation and some examples. Also I'd hope/expect NEWS to be more comprehensive -- whatsnew shouldn't need to have every little thing in it.

+1. NEWS ought to be complete, with respect to changes that could remotely effect existing code. whatsnew.tex should focus on things that are both new and useful.

Regards, Martin