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

[Benjamin Peterson]

2009/3/17 Raymond Hettinger <python at rcn.com>:
> FWIW, I think the examples need to be *very* short.
> The functions.rst page is growing hard to read because
> of all of the lengthy examples, caveats, warnings, and
> saying verbosity.  We don't want to turn the main docs
> into a tutorial.  It makes them harder to use.   If someone
> just wants to scan what the builtin functions do, they now
> face a very lengthy page of reading.  It's getting too fat.

I think what really needs to happen is that function.rst and
stdtypes.rst need to split up into multiple pages. I believe Georg had
some intentions of doing that one day. It might make a good sprint
project.

>
> I think the example below is way too long.

Because it makes the page too long or because the code is too long?




-- 
Regards,
Benjamin