BJörn Lindqvist wrote: > > > 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.
semantics, semantics, semantics (see earlier posts on this topic). but sure, a wiki engine with support for custom source syntax (to support python-oriented semantic markup) and section editing could work. (moinmoin has the former, but not the latter, afaik). </F>
_______________________________________________ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com