Message135634
| 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.2484376e-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. |
|