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