[Python-checkins] r70438 - python/trunk/Doc/library/functions.rst

Raymond Hettinger python at rcn.com
Tue Mar 17 22:14:53 CET 2009


> I don't consider the two argument usage of iter() a tutorial topic.

I'll rewrite the example so that it's length is proportionate to its 
information content.

We really do need to show some editorial restraint.  It's easy
to damage the usability of the docs with clutter, not matter
how well intentioned.

On a separate topic, we also need to make an effort to look
at all of the big/loud caveat/warning blocks to make sure they
are really necessary.  No other language docs advertise 
themselves as being full of minefields.  Look at the main Java
docs for comparison.  They are shot and sweet and say what
a function does, period.


Raymond


More information about the Python-checkins mailing list