[Python-Dev] New Pythondoc by effbot (original) (raw)

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