Re: Interactive Doc Comments - Their Future?

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: "Jonathan S(dot) Katz" <jonathan(dot)katz(at)excoventures(dot)com>, Dave Page <dpage(at)pgadmin(dot)org>, PostgreSQL WWW Mailing List <pgsql-www(at)postgresql(dot)org>
Subject: Re: Interactive Doc Comments - Their Future?
Date: 2014-03-05 16:57:39
Message-ID: 20140305165739.GB7325@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-www

On Wed, Mar 5, 2014 at 10:43:57AM -0500, Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > On Wed, Mar 5, 2014 at 10:36:02AM -0500, Jonathan Katz wrote:
> >> With that said, does anyone involved with -docs pay attention to new
> >> comments? I'm not sure if an alert is sent over there. If it is,
> >> it makes the submissions much more useful and allows for a level of
> >> interactivity.
>
> > I believe Tom Lane goes over the comments before every major release and
> > merges useful suggestions into our docs.
>
> Uh, no. That would possibly be a useful thing to do, but I don't do it
> --- I don't even have a way to examine the existing comments, short of
> manually visiting every one of the HTML pages.

Uh, I see you tried to do it in 2003:

http://www.postgresql.org/message-id/20545.1068921919@sss.pgh.pa.us

and I see you doing it in 2005:

commit 7da8623a562d3f6c25363796ed3df086a4da4594
Author: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Date: Sun Jan 9 18:58:10 2005 +0000

Last batch of updates in response to 7.4 interactive docs comments.

I assumed you were still doing it, but I don't see anything post-2005,
so I am concerned we have not been doing it recently. Can someone
confirm this and perhaps do it for post-2005?

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

+ Everyone has their own god. +

In response to

Browse pgsql-www by date

  From Date Subject
Next Message Magnus Hagander 2014-03-05 19:17:18 Re: Interactive Doc Comments - Their Future?
Previous Message Jonathan S. Katz 2014-03-05 16:09:13 Re: Interactive Doc Comments - Their Future?