[Python-Dev] Doc/whatsnew/* v. Misc/NEWS

[Martin v. Löwis]

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