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