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. +
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? |