> 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Ă . -- http://mail.python.org/mailman/listinfo/python-list