Python Library Reference is tutorial, not reference

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


[aurora]
> 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 <http://python.net/~goodger>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 261 bytes
Desc: OpenPGP digital signature
URL: <http://mail.python.org/pipermail/python-list/attachments/20041016/e2a9b6a4/attachment.pgp>


More information about the Python-list mailing list