Do you feel bad because of the Python docs?

Jason Friedman jsf80238 at gmail.com
Thu Feb 28 05:59:58 CET 2013


> Python has a nice Tutorial for beginners. It is an integral part of the doc
> set. To ignore that (and the indexes) in discussing the usability of Python
> docs by beginners is to lie. (If beginners who actually read the tutorial
> have problems with particular paragraphs, improvements can be and have been
> made.)

I never thought about the quality of the Python docs until reading
these posts.  I started with Python by reading the tutorial and
browsing the module pages and have reached some level of competency.
I suppose the module pages could stand to have more examples, but as
Chris Angelico says this list should be considered part of the
documentation, in which case the documents plus this list effectively
give me any example I am wanting.  I am very grateful to those who
have given their time writing the existing documentation, answering
questions on this list, and of course writing the language!  Python
has allowed me to be more successful at my job than the other
languages I considered.

The lazy and workable approach is to read the module documentation,
make a reasonable effort, follow
http://www.catb.org/esr/faqs/smart-questions.html, and voilà.



More information about the Python-list mailing list