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.
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe:
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com