improving the Python docs -- a wiki? copy PHP's model?

Roger Binns rogerb at rogerbinns.com
Wed May 5 01:11:40 EDT 2004


> As Andrew commented, there's nothing stopping you from
> contributing.

Ask anyone who works on PHP.  Their system is really good
and greatly helps developer productivity.  The people who
work on the doc incorporate the comments into the next
doc releases and usually wipe them clean.

It is trivial to add new comments.  Sure one could do
it via SourceForge instead, but that is a far greater
hassle.  Every single little step you put in the way
makes it less likely people will contribute.  If you
are running cathedral style development, then that is
fine.

> There's also nothing stopping you from setting
> up a wiki yourself so people can comment on various pages
> of the official documentation.

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.

Roger







More information about the Python-list mailing list