Changes in this release docs

Jeff Blaine cjblaine at gmail.com
Fri Sep 17 16:49:42 EDT 2004


Martin v. Löwis wrote:
>> Something that has always bothered me about the 'Changes in this
>> release' docs for new features (generators for instance):  There's
>> usually no explanation for why the feature was added.
>
> Which document are you specifically referring to? AFAICT, there is
> no document titled "Changes in this release", atleast not for Python.

I guess I should have used the exact wording.

http://docs.python.org/whatsnew/whatsnew23.html

>> I don't think it's reasonable to expect language _users_ to keep
>> up with PEPs, etc.
> 
> But is it asked to much for users to read the PEP when they want
> to find out the rationale for a change?

I'm not really interested in rationalization of a change.  That's
what the PEPs are for.

I don't really know how to respond to you.

I know my point and how I feel about it and why I had a "reaction"
to what I was reading.  Personally, I think it's something that
would better Python release notes with minimal effort and get people
up to speed better, faster, etc.

That said, I wholeheartedly thank Andrew K. for his many years of
work on the language, and don't mean to slight his document.

Merely a suggestion.  Bye.



More information about the Python-list mailing list