Re: Interactive docs idea - Mailing list pgsql-hackers

From Greg Stark
Subject Re: Interactive docs idea
Date
Msg-id 87ekdehv2t.fsf@stark.xeocode.com
Whole thread Raw
In response to Re: Interactive docs idea  (Alvaro Herrera <alvherre@dcc.uchile.cl>)
Responses Re: Interactive docs idea  (Christopher Kings-Lynne <chriskl@familyhealth.com.au>)
List pgsql-hackers
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.

-- 
greg



pgsql-hackers by date:

Previous
From: Michael Fuhr
Date:
Subject: Re: Regression failures on freebsd
Next
From: Christopher Kings-Lynne
Date:
Subject: Re: Interactive docs idea