Re: Interactive docs idea

From: Greg Stark <gsstark(at)mit(dot)edu>
To: pgsql-hackers(at)postgresql(dot)org
Subject: Re: Interactive docs idea
Date: 2005-04-14 03:54:18
Message-ID: 87ekdehv2t.fsf@stark.xeocode.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Alvaro Herrera <alvherre(at)dcc(dot)uchile(dot)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

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Christopher Kings-Lynne 2005-04-14 04:04:52 Re: Interactive docs idea
Previous Message Michael Fuhr 2005-04-14 02:57:32 Re: Regression failures on freebsd