[Python-Dev] New Pythondoc by effbot

BJörn Lindqvist bjourne at gmail.com
Mon Jan 23 10:32:43 CET 2006


> > Have you studied wikipedia's approach? It's multi-layered and worth
> > learning from (start with their FAQ on editing).
> >
> > (And by the way, I am *not* advocating writing the docs as one big
> > wikipedia -- only the user commentary.)
>
> to clarify, I'm advocating maintaining the docs via a restricted wiki-like
> system, and using a blog-style discussion board or a wiki to collect non-
> specific user commentary.

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.

--
mvh Björn


More information about the Python-Dev mailing list