From owner-svn-doc-all@FreeBSD.ORG Tue Feb 19 22:22:13 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 98E79395; Tue, 19 Feb 2013 22:22:13 +0000 (UTC) (envelope-from gkeramidas@gmail.com) Received: from mail-ee0-f51.google.com (mail-ee0-f51.google.com [74.125.83.51]) by mx1.freebsd.org (Postfix) with ESMTP id 42F87B47; Tue, 19 Feb 2013 22:22:12 +0000 (UTC) Received: by mail-ee0-f51.google.com with SMTP id d17so3728783eek.10 for ; Tue, 19 Feb 2013 14:22:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:date:from:to:subject:message-id:references :mime-version:content-type:content-disposition:in-reply-to; bh=WhtScrTvpMce9MfKA4coko0JUrXa5q8qZ19TJjkYtmg=; b=yASyCkh4XIfwilTKIwB5VaZli2lE/x/eQ9L2/3FDitDx6LQCtzPYngmWeezN7tbNrg if7oLWcA+5QQlYahJRa0bBdL2hULclkgfpPW80ipd/oBwuarz5vrM1YT6aCUxSu+JfQp BXObshc1RBY/2DYHA4iE5seuGu3EHDI++rGHF/L10s5wR2JROMHasTFYBxjuI8GTgp/U Lw/LwKDKRdwMIbmDeLllXqWVdx7XhCBHkBSCyeGF59vJBdMWWNNrxsfA6Er4CQaK68oI 5MjfZQJOyUZjKxejrP+ASjbaYDEZyI5eD8RZfXq0mZ5vwhyQY1rrPVcDi5OjE81LYGE0 mUGQ== X-Received: by 10.14.5.6 with SMTP id 6mr61474451eek.42.1361312525158; Tue, 19 Feb 2013 14:22:05 -0800 (PST) Received: from saturn (217-162-217-29.dynamic.hispeed.ch. [217.162.217.29]) by mx.google.com with ESMTPS id k7sm103485764een.8.2013.02.19.14.22.03 (version=TLSv1.2 cipher=RC4-SHA bits=128/128); Tue, 19 Feb 2013 14:22:04 -0800 (PST) Sender: Giorgos Keramidas Date: Tue, 19 Feb 2013 23:22:00 +0100 From: Giorgos Keramidas To: Eitan Adler , Glen Barber , 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> References: <201302161543.r1GFh9Ek038848@svn.freebsd.org> <20130219215627.GB92116@felucia.tataz.chchile.org> <20130219220417.GC1514@glenbarber.us> <20130219221400.GC92116@felucia.tataz.chchile.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <20130219221400.GC92116@felucia.tataz.chchile.org> X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 19 Feb 2013 22:22:13 -0000 On 2013-02-19 23:14, Jeremie Le Hen 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 :-)