Re: 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.

-- 
greg