[Python-Dev] r54457 - python/trunk/Doc/whatsnew/whatsnew26.tex (original) (raw)

Steve Holden steve at holdenweb.com
Tue Mar 20 23:29:50 CET 2007

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

More information about the Python-Dev mailing list