From: David Fetter <david@fetter.org>
To: Ross J. Reedstrom <reedstrm@rice.edu>
Cc: Alvaro Herrera <alvherre@commandprompt.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Thom Brown <thom@linux.com>
Cc: Robert Haas <robertmhaas@gmail.com>
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>
Subject: Re: [HACKERS] Sync rep doc corrections
Date: Mon, 7 Mar 2011 11:07:41 -0800
Message-ID: <20110307190741.GD12122@fetter.org> (raw)
In-Reply-To: <20110307190105.GB21734@rice.edu>
References: <AANLkTikUBhskJ8ALpr=KBc66toJ1CvmupTJFgaTXwc-d@mail.gmail.com>
<AANLkTimE9vAC1Xb1Ge4weFJ4unExzsAUExFwk=L2NvVX@mail.gmail.com>
<AANLkTimWR2MXBqi-Ann2EYAyOmDNYXMOseNKoMmsq9tD@mail.gmail.com>
<AANLkTimPJ+SczkQd-7_kWQyrDvtrFYSXcmCfU74oZs1Q@mail.gmail.com>
<20110307175106.GA12122@fetter.org>
<AANLkTi=posYheJ5PS1FwOJmMKX93WKG_KRKYE2BoCeEw@mail.gmail.com>
<9160.1299521791@sss.pgh.pa.us>
<1299523373-sup-3966@alvh.no-ip.org>
<20110307190105.GB21734@rice.edu>
On Mon, Mar 07, 2011 at 01:01:05PM -0600, Ross J. Reedstrom wrote:
> 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?
It's not that simple. If it were, I wouldn't have been asking for
this in the first place.
Re: docs, I'd actually like to see that list gone, as the separation
of docs from code is one that's actively unhelpful. We don't have a
separate "docs" team, and we rightly put the responsibility of
documenting changes on the person or people patching them in.
Cheers,
David.
--
David Fetter <david@fetter.org> http://fetter.org/
Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: dfetter
Skype: davidfetter XMPP: david.fetter@gmail.com
iCal: webcal://www.tripit.com/feed/ical/people/david74/tripit.ics
Remember to vote!
Consider donating to Postgres: http://www.postgresql.org/about/donate
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: david@fetter.org, reedstrm@rice.edu, alvherre@commandprompt.com, tgl@sss.pgh.pa.us, thom@linux.com, robertmhaas@gmail.com, pgsql-hackers@postgresql.org
Subject: Re: [HACKERS] Sync rep doc corrections
In-Reply-To: <20110307190741.GD12122@fetter.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox