Doc suggestions (was: Why "class exceptions" are not deprecated?)

[Fredrik Lundh]

Ed Singleton wrote:

> This would be a perfect situation for a wiki.  I think it would be a
> good experiment to have a wiki containing the documentation (separate
> from the main documentation and clearly marked experimental for the
> moment), and to see if it did self-organise as wikis often do.

agreed.

> It would greatly reduce the work need by the people currently
> responsible for documentation (they just have to read through and make
> sure things are correct) and if a page has been significantly improved
> by the community and double checked by an expert, it could be promoted
> to the official version of the documentation.

absolutely.

(and promoting could simply be done by tagging a given wiki revision as
the official source, using something like http://effbot.org/django-pageview
or a static version thereof, as the front-end renderer)

> If the whole thing descends into chaos, the wiki (pages) could just be
> deleted and we continue with the current system.
>
> As Python has such an excellent community, it would be a shame not to
> give them more responsibility in this area

the entire python.org site (and Python) would benefit for improved support
for micro-contributions, but I doubt that will ever happen under the current
regime.

> (I'm actually tempted to just copy and paste each page from the
> tutorial into the current wiki but I'd hate for it all to be deleted
> after doing that).

just do it!

</F>