From: | David Fetter <david(at)fetter(dot)org> |
---|---|
To: | "Ross J(dot) Reedstrom" <reedstrm(at)rice(dot)edu> |
Cc: | Alvaro Herrera <alvherre(at)commandprompt(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Thom Brown <thom(at)linux(dot)com>, 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:07:41 |
Message-ID: | 20110307190741.GD12122@fetter.org |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs pgsql-hackers |
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(at)fetter(dot)org> http://fetter.org/
Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: dfetter
Skype: davidfetter XMPP: david(dot)fetter(at)gmail(dot)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
From | Date | Subject | |
---|---|---|---|
Next Message | Josh Berkus | 2011-03-07 19:12:34 | Re: [DOCS] Sync rep doc corrections |
Previous Message | Ross J. Reedstrom | 2011-03-07 19:01:05 | Re: [HACKERS] Sync rep doc corrections |
From | Date | Subject | |
---|---|---|---|
Next Message | Josh Berkus | 2011-03-07 19:12:34 | Re: [DOCS] Sync rep doc corrections |
Previous Message | Ross J. Reedstrom | 2011-03-07 19:01:05 | Re: [HACKERS] Sync rep doc corrections |