Python documentation too difficult for beginners

jk sanjo_ie at yahoo.com
Wed Nov 3 09:50:48 CET 2010


On Nov 2, 11:06 pm, Lawrence D'Oliveiro <l... at geek-
central.gen.new_zealand> wrote:
> In message
> <a5dc65e1-3a72-4160-90e3-956a456be... at 26g2000yqv.googlegroups.com>, jk
> wrote:
>
> > This (http://epydoc.sourceforge.net/stdlib/) is what I'm talking
> > about.
>
> Framesets? Is that really your idea of well-laid-out documentation? Using a
> feature which has been derided (and dropped in HTML5) because of its effect
> on usability and accessibility?

No, the framesets suck, and I agree that Javadoc isn't perfect.
Actually, I do think the PHP docs are the best I've found as a
reference. Javadocs just need a few tweaks and they'd be better (an
index at the top so you don't have to scroll down, no framesets, a
search engine). Still think they're better than the python docs though.



More information about the Python-list mailing list