[New-bugs-announce] [issue21956] Deleted document should not appear in 3.4 docs

[Brandon Rhodes]

New submission from Brandon Rhodes:

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.

----------
messages: 222741
nosy: brandon-rhodes
priority: normal
severity: normal
status: open
title: Deleted document should not appear in 3.4 docs

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21956>
_______________________________________