[issue11948] Tutorial/Modules - small fix to better clarify the modules search path

Raymond Hettinger report at bugs.python.org
Mon May 9 21:19:32 CEST 2011


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

One other stylistic note.  The tone of the tutorial (and all the docs) needs to be respectful of the readers intelligence.  We don't presume that the readers are stupid.  We lay out the relevant information, show motivating use cases, provide glossary links, and do our best to connect-the-dots, but don't talk down them or waste their time.

The recent doc patch for using the in-operator instead of str.find borders on the edge of not giving readers credit for being able to make trivial inferences about the API.

----------

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


More information about the Python-bugs-list mailing list