Re: Interactive docs idea

From: Alvaro Herrera
Subject: Re: Interactive docs idea
Date: ,
Msg-id: 20050414024319.GB27227@dcc.uchile.cl
(view: Whole thread, Raw)
In response to: Interactive docs idea  (Christopher Kings-Lynne)
Responses: Re: Interactive docs idea  (Greg Stark)
List: pgsql-hackers

Tree view

Interactive docs idea  (Christopher Kings-Lynne, )
 Re: Interactive docs idea  (Alvaro Herrera, )
  Re: Interactive docs idea  (Greg Stark, )
   Re: Interactive docs idea  (Christopher Kings-Lynne, )
    Re: Interactive docs idea  (Andrew Dunstan, )
 Re: Interactive docs idea  ("Dave Page", )
  Re: Interactive docs idea  (Robert Treat, )
   Re: Interactive docs idea  (Alvaro Herrera, )
  Re: Interactive docs idea  (Greg Stark, )
   Re: Interactive docs idea  (Alvaro Herrera, )
    Re: Interactive docs idea  (Greg Stark, )
     Re: Interactive docs idea  (Alvaro Herrera, )
      Re: Interactive docs idea  (Greg Stark, )
   Re: Interactive docs idea  ("Joshua D. Drake", )
 Re: Interactive docs idea  ("Dave Page", )
  Re: Interactive docs idea  ("Jim C. Nasby", )

On Thu, Apr 14, 2005 at 09:41:43AM +0800, Christopher Kings-Lynne wrote:

> After working on PHP for a few weeks, I see that what they do with their 
> interactive docs is have any comments posted get emailed to the docs 
> list.  Do we do this?

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.)

Also we could take care of comments asking for support if we do this.
Not sure if there are a lot of those, but I remember seeing some
in the past.

-- 
Alvaro Herrera (<alvherre[@]dcc.uchile.cl>)
"Es filósofo el que disfruta con los enigmas" (G. Coli)



pgsql-hackers by date:

From: Christopher Kings-Lynne
Date:
Subject: Re: Interactive docs idea
From: "Dave Page"
Date:
Subject: Re: Interactive docs idea