Re: [HACKERS] Sync rep doc corrections

From: "Ross J(dot) Reedstrom" <reedstrm(at)rice(dot)edu>
To: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Thom Brown <thom(at)linux(dot)com>, David Fetter <david(at)fetter(dot)org>, Robert Haas <robertmhaas(at)gmail(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: [HACKERS] Sync rep doc corrections
Date: 2011-03-07 19:01:05
Message-ID: 20110307190105.GB21734@rice.edu
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Mon, Mar 07, 2011 at 03:45:17PM -0300, Alvaro Herrera wrote:
> Excerpts from Tom Lane's message of lun mar 07 15:16:31 -0300 2011:
>
> > If we do that then it becomes worth wondering what the -docs list is for
> > at all. Maybe we *should* get rid of it; I dunno. I see your point
> > about how the factual issues involved in a docs change ought to be
> > vetted on -hackers, but on the other hand the traffic on -hackers is so
> > high already that I'm not happy about folding another list with a
> > reasonably distinct charter into it.
>
> Searching for doc changes/suggestions is helped tremendously by having
> them in a separate list. -1 for merging it with -hackers. I have no
> opinion on the -hackers crossposting issue as it doesn't affect me at
> all.

Definitely don't merge. Crossposting, I think, should be reserved for
significant factual changes to docs of features that are in current
development, like ... syncrep. :-) Basically, keep docs work on docs,
but cross-post to hackers when a cross-check is needed. Don't routinely
crosspost, lest that train hackers to ignore the docs posts. After all,
we insist that developers of patches submit docs: correct documentation
is a valid concern for all developers.

Ross
P.S. Everyone is aware of the settings for majordomo, so you only get
one of any crosspost, right?
--
Ross Reedstrom, Ph.D. reedstrm(at)rice(dot)edu
Systems Engineer & Admin, Research Scientist phone: 713-348-6166
Connexions http://cnx.org fax: 713-348-3665
Rice University MS-375, Houston, TX 77005
GPG Key fingerprint = F023 82C8 9B0E 2CC6 0D8E F888 D3AE 810E 88F0 BEDE

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message David Fetter 2011-03-07 19:07:41 Re: [HACKERS] Sync rep doc corrections
Previous Message Alvaro Herrera 2011-03-07 18:45:17 Re: [HACKERS] Sync rep doc corrections

Browse pgsql-hackers by date

  From Date Subject
Next Message David Fetter 2011-03-07 19:07:41 Re: [HACKERS] Sync rep doc corrections
Previous Message Josh Berkus 2011-03-07 19:00:47 Re: Alpha4 release blockers (was Re: wrapping up this CommitFest)