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

[Mark Shannon]

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.

Cheers,
Mark.