Re: Annotatable on-line documentation - Mailing list pgsql-general

From Peter Eisentraut
Subject Re: Annotatable on-line documentation
Date
Msg-id Pine.LNX.4.30.0102162134140.1009-100000@peter.localdomain
Whole thread Raw
In response to Annotatable on-line documentation  (Richard <poboxcanada@yahoo.com>)
List pgsql-general
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/


pgsql-general by date:

Previous
From: David Wheeler
Date:
Subject: Re: Case insensitive selects?
Next
From: "Mitch Vincent"
Date:
Subject: Re: order of clauses