Python documentation too difficult for beginners

Nizumzen nizumzen at mcnuggets.com
Wed Nov 3 00:05:03 CET 2010


On 2010-11-02 10:42:22 +0000, jk said:

> Hi,
> 
> I've been coding in PHP and Java for years, and their documentation is
> concise, well structured and easy to scan.

Are you mad? Javadoc is one of the worst examples of source code 
documentation I can possibly imagine. I would go as far to say that the 
Python guys should do exactly the opposite of Javadoc.




More information about the Python-list mailing list