improving the Python docs -- a wiki? copy PHP's model?

Doug Holton insert at spam.here
Wed May 5 11:18:53 EDT 2004


> Yes, except the official doc would then need a link
> at the bottom of each page pointing to the wiki.  The
> PHP docs have it all there in one page, no need to look
> in two locations etc.

I think it would be great to have moderated commentable docs like PHP.

I'm not sure what docs to start off with though.  The Python reference 
manual isn't written in a way that separates a page for each keyword or 
builtin like PHP's.

Or should we start off with a combination of the manuals with an 
automatically generated reference from the standard library like this 
epydoc one: http://epydoc.sourceforge.net/stdlib/
or pydoc: http://pydoc.org/

Perhaps we could take all the reference documents and convert them from 
html to wiki and load them into the python wiki or another wiki, with a 
"comments" section added at the bottom of each page.  We're talking 
hundreds of pages though.



More information about the Python-list mailing list