Date: Tue, 19 Feb 2013 23:22:00 +0100 From: Giorgos Keramidas <keramida@FreeBSD.org> To: Eitan Adler <eadler@freebsd.org>, Glen Barber <gjb@freebsd.org>, svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org Subject: Re: svn commit: r40980 - head/en_US.ISO8859-1/books/handbook/printing Message-ID: <20130219222159.GC15736@saturn> In-Reply-To: <20130219221400.GC92116@felucia.tataz.chchile.org> References: <201302161543.r1GFh9Ek038848@svn.freebsd.org> <20130219215627.GB92116@felucia.tataz.chchile.org> <20130219220417.GC1514@glenbarber.us> <CAF6rxgmB-ZyfaZOJcP_sCX8zX_OopbJ=WXb1Cuj-rnt7W7yx7A@mail.gmail.com> <20130219221400.GC92116@felucia.tataz.chchile.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2013-02-19 23:14, Jeremie Le Hen <jlh@FreeBSD.org> wrote:
> On Tue, Feb 19, 2013 at 05:06:18PM -0500, Eitan Adler wrote:
> > I did not intend to offend anyone and if I did, I apologize.
> >
> > Perhaps any of the following?
> >
> > "Twiddle with a poorly worded sentence."
> > "Make this sentence more clear"
> > or
> > "Avoid references to the first person and clarify sentence."
>
> Yes. Basically, let's try to be as neutral as possible.
> Thank you very much for your understanding :).
That's a fair point. It's always possible to write commit logs that can
not seem derogatory, e.g. instead of:
Fix brain-damaged foo
the more positive ways of writing the same are nicer, e.g.:
Improve wording of foo
Rewrite foo to increase clarity
Better wording for foo
Having said that, we're all still humans and having spent a long time
trying to understand the text may often result in the person who does
the editing feeling frustrated that so much effort was required to grasp
the real meaning. So let's not beat ourselves too much about it :-)
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130219222159.GC15736>