From owner-freebsd-doc@FreeBSD.ORG Mon Nov 24 20:06:17 2008 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 837CC106567A for ; Mon, 24 Nov 2008 20:06:17 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: from yx-out-2324.google.com (yx-out-2324.google.com [74.125.44.29]) by mx1.freebsd.org (Postfix) with ESMTP id 32D268FC18 for ; Mon, 24 Nov 2008 20:06:16 +0000 (UTC) (envelope-from r.c.ladan@gmail.com) Received: by yx-out-2324.google.com with SMTP id 8so909437yxb.13 for ; Mon, 24 Nov 2008 12:06:16 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to :subject:cc:in-reply-to:mime-version:content-type :content-transfer-encoding:content-disposition:references; bh=A9n/N/vB3fIWIuwxX2rsX3Z9EEu+8HIi6fUvXS3WOD0=; b=xIYt4GvYIMAPQP2rYuPnh6MnHCw0mdPWXOmTQERDZCUPLWQ1pQXHBICdaLEsPtQa8M Wcjx+Bk+Mi1TLynmeYvame9lEU/GXf4rv+mzkCpb2JQdHEExKHQKnitzomAWqfgX3heb D6Pjz5uwbzou+vuQh6qQD/b2yodTYnRsq/yys= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:in-reply-to:mime-version :content-type:content-transfer-encoding:content-disposition :references; b=vYcsaKclTLTUAK6Gd+1EqK8P1ghEDfxe/L9YHen44OG9kkloKbqe28I1wimrmwZRbI CW5tqvzQ8FoE/2gZnz/2pQOQRrPQVLFBILRK6+VDg7A0cV/3wYztV4XAfVdPLSupdS3h fQQaIedkYI8VSTncAdVQxEgAL/dWIE6MtMtPQ= Received: by 10.151.14.5 with SMTP id r5mr7642083ybi.163.1227556634289; Mon, 24 Nov 2008 11:57:14 -0800 (PST) Received: by 10.151.147.11 with HTTP; Mon, 24 Nov 2008 11:57:14 -0800 (PST) Message-ID: Date: Mon, 24 Nov 2008 20:57:14 +0100 From: "Rene Ladan" To: "Manolis Kiagias" In-Reply-To: <492B01C4.6090707@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <492AE607.4020208@gmail.com> <20081124135107.06a8af26.trhodes@FreeBSD.org> <87abbp3q5o.fsf@kobe.laptop> <492B01C4.6090707@gmail.com> Cc: Tom Rhodes , doc@freebsd.org, pgj@freebsd.org, gabor@kovesdan.org, Giorgos Keramidas , Remko Lodder Subject: Re: A patch for the 'geom' chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 24 Nov 2008 20:06:17 -0000 2008/11/24 Manolis Kiagias : > Giorgos Keramidas wrote: >> On Mon, 24 Nov 2008 13:51:07 -0500, Tom Rhodes wrote: >> >>> On Mon, 24 Nov 2008 19:36:07 +0200 >>> Manolis Kiagias wrote: >>> >>>> http://people.freebsd.org/~manolis/geom.txt >>>> >> >> >>> This looks pretty good actually. I would probably change the >>> following: >>> >>> + >>> + Labeling Your Boot Disk's Partitions >>> >>> to: >>> >>> Labeling Partitions on the Boot Disk >>> >>> And there are a lot of "You" references. I've tried to write this >>> without invoking the user as much as possible and may make reading the >>> entire chapter difficult. I would prefer we not talk to the user >>> though. >>> >> >> I am not sure if I will have the time to read the full patch tonight, >> but Tom is quite right about avoiding "you" when possible. >> >> > Thanks. I will try to rephrase most parts into passive voice where > possible. I guess I am somewhat influenced by the Greek translations, > where sometimes passive voice sounds unnatural ;) > I think the same is true for the Dutch language. Using passive voice sometimes sounds too formal/distant IMHO (it makes me think of legal texts). Active voice also involves the reader more. It also makes it possible to refer to e.g. 'their computer' instead of 'a computer', which can be useful in examples. Regards, Rene -- http://www.rene-ladan.nl/ GPG fingerprint = E738 5471 D185 7013 0EE0 4FC8 3C1D 6F83 12E1 84F6 (subkeys.pgp.net)