[Python-Dev] New Pythondoc by effbot
Mike Brown
mike at skew.org
Wed Jan 25 04:25:10 CET 2006
BJ> Why does it have to be "wiki-like"? Why can't it be a wiki? MediaWiki
> seem to work pretty well for a lot of software projects that have put
> their documentation in a wiki. Talk pages for commentary and primary
> pages for reviewed content.
And inconsistent formatting from article to article, limitations in indexing
options, no way to browse a set of documentation specific to a particular
Python release...
I personally like the PHP docs - http://www.php.net/manual/en/
They're not versioned, and users can't modify the indexes or API docs, but
they do get to add annotations. Annotations that reflect errors or major
omissions from the docs can be reviewed by editors and folded into the docs
as needed. *shrug*
More information about the Python-Dev
mailing list