Re: Interactive Doc Comments - Their Future? - Mailing list pgsql-www

From Alvaro Herrera
Subject Re: Interactive Doc Comments - Their Future?
Date
Msg-id 20140306151639.GY4759@eldon.alvh.no-ip.org
Whole thread Raw
In response to Re: Interactive Doc Comments - Their Future?  ("Jonathan S. Katz" <jonathan.katz@excoventures.com>)
Responses Re: Interactive Doc Comments - Their Future?
Re: Interactive Doc Comments - Their Future?
List pgsql-www
Jonathan S. Katz wrote:
> On Mar 5, 2014, at 3:41 PM, Peter Eisentraut wrote:
> 
> > On 3/5/14, 2:17 PM, Magnus Hagander wrote:
> >> Perhaps what we could do is replace them with something that works like
> >> the bug report form. So instead of submitting a comment into a static
> >> space, they turn into an email to the -docs list, which can then get
> >> discussion around it and eventually turn it into a modifications for the
> >> actual docs? 
> > 
> > That seems most useful to me.
> 
> Yes, because ultimately, with a lot of doc comments that come in, this is what I would do anyway (and in fairness, I
havequeued up a bunch to send over)
 

So in short the "interactive" docs would go away (i.e. no comments are
displayed), and the form in the docs/interactive/ pages would submit a
comment to pgsql-docs, so that hopefully we merge the useful ones into
the main text.  The docs/interactive/ URLs would redirect to the static
pages (or perhaps serve the same contents without redirecting?)

Is that it?

-- 
Álvaro Herrera                http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Training & Services



pgsql-www by date:

Previous
From: "Jonathan S. Katz"
Date:
Subject: Re: Interactive Doc Comments - Their Future?
Next
From: Magnus Hagander
Date:
Subject: Re: Interactive Doc Comments - Their Future?