Re: Interactive Doc Comments - Their Future?

On Thu, Mar 6, 2014 at 12:16:39PM -0300, Alvaro Herrera wrote:
> 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 have queued 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?)

Good. I have disliked that users had to choose with/without comments
before seeing the docs.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ Everyone has their own god. +