Author rhettinger
Recipients docs@python, eric.araujo, ezio.melotti, r.david.murray, rhettinger, sandro.tosi, terry.reedy
Date 2011-05-09.19:19:31
SpamBayes Score 2.24844e-06
Marked as misclassified No
Message-id <1304968772.47.0.445339267356.issue11948@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2011-05-09 19:19:32rhettingersetrecipients: + rhettinger, terry.reedy, ezio.melotti, eric.araujo, r.david.murray, sandro.tosi, docs@python
2011-05-09 19:19:32rhettingersetmessageid: <1304968772.47.0.445339267356.issue11948@psf.upfronthosting.co.za>
2011-05-09 19:19:31rhettingerlinkissue11948 messages
2011-05-09 19:19:31rhettingercreate