From: Robert Treat <xzilla@users.sourceforge.net>
To: "Dave Page" <dpage@vale-housing.co.uk>
Subject: Re: Comment forms in interactive docs
Date: Sat, 4 Sep 2004 22:32:49 -0400
User-Agent: KMail/1.6.2
Cc: "Marc G. Fournier" <scrappy@postgresql.org>,
	"Tom Lane" <tgl@sss.pgh.pa.us>, "Devrim GUNDUZ" <devrim@gunduz.org>,
	"PostgreSQL WWW Mailing List" <pgsql-www@postgresql.org>
References: 
 <E7F85A1B5FF8D44C8A1AF6885BC9A0E41A796E@ratbert.vale-housing.co.uk>
In-Reply-To: 
 <E7F85A1B5FF8D44C8A1AF6885BC9A0E41A796E@ratbert.vale-housing.co.uk>
MIME-Version: 1.0
Content-Disposition: inline
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <200409042232.49468.xzilla@users.sourceforge.net>

On Friday 03 September 2004 03:18, Dave Page wrote:
> > -----Original Message-----
> > From: pgsql-www-owner@postgresql.org
> > [mailto:pgsql-www-owner@postgresql.org] On Behalf Of Marc G. Fournier
> > Sent: 03 September 2004 00:57
> > To: Tom Lane
> > Cc: Devrim GUNDUZ; PostgreSQL WWW Mailing List
> > Subject: Re: [pgsql-www] Comment forms in interactive docs
> >
> > On Thu, 2 Sep 2004, Tom Lane wrote:
> > > Devrim GUNDUZ <devrim@gunduz.org> writes:
> > >> There are comments forms interactive docs. I think we
> >
> > should remove them.
> >
> > >> Who follows the user comments in there? I'm sure, noone!
> > >
> > > Actually, we've made a practice of scavenging for useful
> >
> > comments at
> >
> > > least once a release cycle.  There's a lot of crud in
> >
> > there, I agree,
> >
> > > but some good ideas about missing material too.  Anyway,
> >
> > what is your
> >
> > > idea of "interactive" docs if not ones that people can comment on?
> >
> > I know that I tend to make extensive use of the user
> > 'comments' when I'm looking at similar in the PHP docs ...
> > you usually get some valuable examples that the docs are
> > seriously lacking ...
>
> Very true, the php idocs are excellent. The question is, how do we
> encourage submissions of the same quality, without all the 'Where can I
> get pdf docs' and 'why doesn't my C program work' questions?
>

I believe one significant difference is the php doc submissions are moderated, 
and therefore subject to less cruft.  I've suggested in the past that doc 
submissions get posted to -www or -doc, but neither group seemed interested 
in supporting that.

-- 
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL