Python Library Reference is tutorial, not reference

David Goodger goodger at
Sat Oct 16 19:59:58 CEST 2004

> Sometimes it is rather frustrated to use the Python Library Reference. 
> It seems each section is hand crafted and it is up to the author decide 
> the organization and coverage.
... many relevant examples omitted ...

You make some good points.  It's true that Python's documentation is
not perfect.

> Is Python going to adopt a more systematic organization of reference  
> materials,

Yes, if and only if someone puts in the effort.

Are you willing to do more than just complain?  If so, please choose a
chapter and produce a patch.  Assign it to me, and I'll make sure it
gets applied quickly -- if the patch is of good quality.  After a few
patches, I'll recommend to python-dev that you be granted direct CVS
access, which would make the process that much more efficient.

David Goodger <>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 261 bytes
Desc: OpenPGP digital signature
URL: <>

More information about the Python-list mailing list