Python Library Reference is tutorial, not reference
David Goodger
goodger at python.org
Sat Oct 16 13:59:58 EDT 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.sig>
More information about the Python-list
mailing list