Python documentation too difficult for beginners
Cameron Simpson
cs at zip.com.au
Wed Nov 3 17:03:37 EDT 2010
On 02Nov2010 04:23, jk <sanjo_ie at yahoo.com> wrote:
| This (http://epydoc.sourceforge.net/stdlib/) is what I'm talking
| about.
|
| Why aren't the official docs like this, and why has it taken me 2 days
| of searching? All this needs is a search engine behind it and it'd be
| perfect.
It looks a lot like javadoc. But its weakness is stuff like this:
http://epydoc.sourceforge.net/stdlib/Canvas.Polygon-class.html
Automatic docness, no useful information.
And of course the ugliness; I find the python docs much nicer to look
at. But I do wish the cross referencing was a bit better, often.
--
Cameron Simpson <cs at zip.com.au> DoD#743
http://www.cskk.ezoshosting.com/cs/
In an insane society, the sane man must appear insane.
- Keith A. Schauer <keith at balrog.dseg.ti.com>
More information about the Python-list
mailing list