public inbox for [email protected]  

help / color / mirror / Atom feed

From: Dave Page <[email protected]>
To: Marc G. Fournier <[email protected]>
To: Tom Lane <[email protected]>
Cc: Devrim GUNDUZ <[email protected]>
Cc: PostgreSQL WWW Mailing List <[email protected]>
Subject: Re: Comment forms in interactive docs
Date: Fri, 3 Sep 2004 08:18:10 +0100
Message-ID: <E7F85A1B5FF8D44C8A1AF6885BC9A0E41A796E@ratbert.vale-housing.co.uk> (raw)

 

> -----Original Message-----
> From: [email protected] 
> [mailto:[email protected]] 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 <[email protected]> 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.

view thread (10+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected]
  Subject: Re: Comment forms in interactive docs
  In-Reply-To: <E7F85A1B5FF8D44C8A1AF6885BC9A0E41A796E@ratbert.vale-housing.co.uk>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox