Python documentation too difficult for beginners

Lawrence D'Oliveiro ldo at geek-central.gen.new_zealand
Wed Nov 3 20:09:08 EDT 2010


In message <mailman.580.1288818221.2218.python-list at python.org>, Cameron 
Simpson wrote:

> But its weakness is stuff like this:
> 
>   http://epydoc.sourceforge.net/stdlib/Canvas.Polygon-class.html
> 
> Automatic docness, no useful information.

But it Conforms to Documentation-Production Metrics as decreed by the 
Corporate Task Force on Policy. So long as the divisions are satisfying the 
official metrics on documentation production, that must mean the project is 
meeting its goals.



More information about the Python-list mailing list