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(at)gmx(dot)net http://yi.org/peter-e/