Re: Annotatable on-line documentation

Peter Eisentraut <peter_e@gmx.net>

From: Peter Eisentraut <peter_e@gmx.net>
To: Richard <poboxcanada@yahoo.com>
Cc: <pgsql-general@postgresql.org>
Date: 2001-02-16T20:38:20Z
Lists: pgsql-general, pgsql-docs
Richard writes:

> Would this lighten the work load on the folk that are
> currently maintaining the docs?  Would it lighten the
> work load for the core developers?  Would it stimulate
> the development of richer documetation?  Would it draw
> some of the load off the mailing lists?

My concerns are mostly that that kind of thing would be abused as a
discussion forum, the quality of the comments is quite low on average, and
the added efforts to weed out the posts on a regular basis seem
prohibite.

I don't see any particular advantage coming from this that couldn't be
achieved in another way.

> A pilot project may be enlightening.  Anyone have
> experience with setting up/maintaining annotatable
> on-line documentation?

What I've seen at PHP and MySQL was enlightening enough for me.  :-(

-- 
Peter Eisentraut      peter_e@gmx.net       http://yi.org/peter-e/