Re: Interactive docs idea - Mailing list pgsql-hackers

From Dave Page
Subject Re: Interactive docs idea
Date
Msg-id E7F85A1B5FF8D44C8A1AF6885BC9A0E472C1CD@ratbert.vale-housing.co.uk
Whole thread Raw
In response to Interactive docs idea  (Christopher Kings-Lynne <chriskl@familyhealth.com.au>)
Responses Re: Interactive docs idea  (Robert Treat <xzilla@users.sourceforge.net>)
Re: Interactive docs idea  (Greg Stark <gsstark@mit.edu>)
List pgsql-hackers

> -----Original Message-----
> From: pgsql-hackers-owner@postgresql.org
> [mailto:pgsql-hackers-owner@postgresql.org] On Behalf Of Greg Stark
> Sent: 14 April 2005 04:54
> To: pgsql-hackers@postgresql.org
> Subject: Re: [HACKERS] Interactive docs idea
>
> Alvaro Herrera <alvherre@dcc.uchile.cl> writes:
>
> > I think it's an interesting idea to mail the comments to
> pgsql-docs, but
> > *please don't* start emulating the PHP behavior regarding comments
> > (leaving the "relevant" ones forever) :-(  I think the PHP
> manuals are
> > very low quality because of the information in comments which really
> > belongs in the main text body (which is crappy in PHP's
> manual anyway
> > IMHO.)
>
> It seems that's not much of a danger -- the interactive
> Postgres documentation
> hardly gets any comments at all in the first place. It would be a big
> improvement if there were some way to encourage many more comments.

We can get from 2 - 10 a day I would guess. They get mailed to a closed
list for moderation.

Regards, Dave


pgsql-hackers by date:

Previous
From: Christopher Kings-Lynne
Date:
Subject: Re: Interactive docs idea
Next
From: Andrew Dunstan
Date:
Subject: Re: Interactive docs idea