Author brandon-rhodes
Recipients brandon-rhodes
Date 2014-07-11.13:07:11
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1405084031.97.0.312909906567.issue21956@psf.upfronthosting.co.za>
In-reply-to
Content
There was an old document in the "howto" folder whose advice was in many cases flat-out wrong, so Raymond Hettinger performed a wonderful public service by deleting it back in 2011:

http://hg.python.org/cpython/rev/80ff78425419

Unfortunately it looks like the process for publishing Python documentation only adds documents, but never deletes them, so a copy of the documentation is still available under the "3.4" document tree:

https://docs.python.org/3.4/howto/doanddont.html

It should be deleted as soon as possible. Because it is presumed that only the most accurate and up-to-date documentation lives under the URL "3.4", people are reading and debating this document's bad advice as though it is official guidance as to how to use the language. (The only hint that something is wrong, alas, is the tiny detail that the top-left of the page says “Python v3.3a0 documentation”).

The advice is currently being debated on Twitter and people are sad that they are supposed to stop using “from foo import bar” in Python.
History
Date User Action Args
2014-07-11 13:07:12brandon-rhodessetrecipients: + brandon-rhodes
2014-07-11 13:07:11brandon-rhodessetmessageid: <1405084031.97.0.312909906567.issue21956@psf.upfronthosting.co.za>
2014-07-11 13:07:11brandon-rhodeslinkissue21956 messages
2014-07-11 13:07:11brandon-rhodescreate