A.M. Kuchling wrote:
On Tue, Mar 20, 2007 at 06:08:24AM +0100, neal.norwitz wrote:
Author: neal.norwitz
Date: Tue Mar 20 06:08:23 2007
New Revision: 54457
+% Should there be a new section here for 3k migration?
+% Or perhaps a more general section describing module changes/deprecation?
+% sets module deprecated
This is an interesting question: should the What's New talk about
Python 3000?
My initial tentative reaction is 'no', because a Py3K section would
need to continue to be updated as Python 3000's definition shifts.
Once previous Python 2.x versions were released, What's New
documents became very static, the only changes being typo fixes and
small corrections and clarifications. Having to continually update
the Py3K section would be annoying, and argues for a separate document
that isn't necessarily tied to Python 2.x releases.
On the other hand, it would be nice to warn users away from idioms
that will break in Py3K, and the What's New is a natural place to do
it. Hm. But the 'porting' section already talks about features that
are being deprecated; is that enough?
Thoughts?
Clearly a need for a new document. We don't want to startle people who
don't want to get involved in version wars (probably 98.5% of all users
aren't even aware of What's New, since they use a Python installed by
someone else, typically their computer vendor or Linux/UNIX distro team).
At the same time we should flag the fact that upcoming changes are
indeed in the works. Possibly a 3.0 Design Snapshot whose title makes
it clear this is a moving target and, among other things, whose content
points the user at a definitive (set of) URL(s) for the latest information.
Putting this information in What's New (except possibly for mentioning
the creation of this new document) would create unnecessary FUD.
regards
Steve
--
Steve Holden +44 150 684 7255 +1 800 494 3119
Holden Web LLC/Ltd http://www.holdenweb.com
Skype: holdenweb http://del.icio.us/steve.holden
Recent Ramblings http://holdenweb.blogspot.com
___
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