[Python-Dev] [RELEASED] Python 3.3.0 alpha 3

[Georg Brandl]

On 05/07/2012 11:00 AM, Mark Shannon wrote:
> Martin v. Löwis wrote:
>>> The What's New document also starts with a long list of PEPs.
>>> This seems to be the standard format as What's New for 3.2 follows the
>>> same layout.
>>>
>>> Perhaps adding an overview or highlights at the start would be a good
>>> idea.
>> 
>> You seem to assume that Python users are not able to grasp long itemized 
>> lists including numbers. I think readers are very capable
>> of filtering this kind of information.
> 
> Just because readers are capable of filtering a long list of PEPs in an 
> arbitrary order does not mean that they should have to.
> Many readers will just skim the list, but would probably read a summary 
> in full.
> 
>> 
>> As for presenting highlights: the PEPs *are* the highlights of a new 
>> release. The numerous bug fixes and minor enhancements don't get listed
>> at all.
> 
> But PEPs can have very different purposes.
> It would be useful to summarize the language changes (with links to the 
> relevant PEPs) separately to library extensions and optimizations.
> 
> If the reader is interested in new features, then information about
> optimisations are just clutter. And vice-versa.

Sorry, I think that's tough luck then.  The list isn't nearly long enough
to warrant splitting up.  The announcement should stay compact.  And as Nick
said, the "What's New" will be there for those who want a longer overview
by topics.

Georg