Content-class: urn:content-classes:message
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Subject: Re: Comment forms in interactive docs 
Date: Fri, 3 Sep 2004 08:18:10 +0100
Message-ID: 
 <E7F85A1B5FF8D44C8A1AF6885BC9A0E41A796E@ratbert.vale-housing.co.uk>
Thread-Topic: [pgsql-www] Comment forms in interactive docs 
Thread-Index: AcSRSI99cjGwzr7DS8+zoYftYzz1GgAPQhOQ
From: "Dave Page" <dpage@vale-housing.co.uk>
To: "Marc G. Fournier" <scrappy@postgresql.org>,
 "Tom Lane" <tgl@sss.pgh.pa.us>
Cc: "Devrim GUNDUZ" <devrim@gunduz.org>,
	"PostgreSQL WWW Mailing List" <pgsql-www@postgresql.org>

=20

> -----Original Message-----
> From: pgsql-www-owner@postgresql.org=20
> [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=20
>=20
> On Thu, 2 Sep 2004, Tom Lane wrote:
>=20
> > Devrim GUNDUZ <devrim@gunduz.org> writes:
> >> There are comments forms interactive docs. I think we=20
> should remove them.
> >> Who follows the user comments in there? I'm sure, noone!
> >
> > Actually, we've made a practice of scavenging for useful=20
> comments at=20
> > least once a release cycle.  There's a lot of crud in=20
> there, I agree,=20
> > but some good ideas about missing material too.  Anyway,=20
> what is your=20
> > idea of "interactive" docs if not ones that people can comment on?
>=20
> I know that I tend to make extensive use of the user=20
> 'comments' when I'm looking at similar in the PHP docs ...=20
> you usually get some valuable examples that the docs are=20
> 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?

Regards, Dave.