svn commit: r40980 - head/en_US.ISO8859-1/books/handbook/printing

Giorgos Keramidas keramida at FreeBSD.org
Tue Feb 19 22:22:13 UTC 2013


On 2013-02-19 23:14, Jeremie Le Hen <jlh at 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 :-)



More information about the svn-doc-all mailing list