Python documentation too difficult for beginners

Tue Nov 2 19:05:03 EDT 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.