Re: Annotatable on-line documentation

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/