From: | "Dave Page" <dpage(at)vale-housing(dot)co(dot)uk> |
---|---|
To: | "Marc G(dot) Fournier" <scrappy(at)postgresql(dot)org>, "Tom Lane" <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | "Devrim GUNDUZ" <devrim(at)gunduz(dot)org>, "PostgreSQL WWW Mailing List" <pgsql-www(at)postgresql(dot)org> |
Subject: | Re: Comment forms in interactive docs |
Date: | 2004-09-03 07:18:10 |
Message-ID: | E7F85A1B5FF8D44C8A1AF6885BC9A0E41A796E@ratbert.vale-housing.co.uk |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-www |
> -----Original Message-----
> From: pgsql-www-owner(at)postgresql(dot)org
> [mailto:pgsql-www-owner(at)postgresql(dot)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(at)gunduz(dot)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?
Regards, Dave.
From | Date | Subject | |
---|---|---|---|
Next Message | Dave Page | 2004-09-03 07:27:04 | www.postgresql.org DNS screwed up. |
Previous Message | Devrim GUNDUZ | 2004-09-03 07:09:02 | Re: New News Entry |