[issue29089] dictionary keys described incorrectly in tutorial

Xezlec report at bugs.python.org
Tue Dec 27 20:45:58 EST 2016


Xezlec added the comment:

> It's the tutorial.  Probably better to just leave it alone.  Precise understanding can come later.

But the problem isn't that it's imprecise.  It's flat-out wrong.  My opinion would be that it's always a bad idea to put wrong information in the documentation, especially when it's the first Google hit.  It can lead to all sorts of confusion and frustration (as it did for me).  Users are likely to assume documentation from any official source is the final word.

If precision is the problem, could it be reworded to be more vague?

----------

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


More information about the Python-bugs-list mailing list