From owner-freebsd-doc@FreeBSD.ORG  Mon Nov 24 19:17:06 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 7F7181065670
	for <doc@freebsd.org>; Mon, 24 Nov 2008 19:17:06 +0000 (UTC)
	(envelope-from keramida@freebsd.org)
Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36])
	by mx1.freebsd.org (Postfix) with ESMTP id D84868FC1E
	for <doc@freebsd.org>; Mon, 24 Nov 2008 19:17:05 +0000 (UTC)
	(envelope-from keramida@freebsd.org)
Received: from kobe.laptop (adsl141-187.kln.forthnet.gr [195.74.240.187])
	(authenticated bits=128)
	by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mAOJ0rXx014412
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT);
	Mon, 24 Nov 2008 21:00:58 +0200
Received: from kobe.laptop (kobe.laptop [127.0.0.1])
	by kobe.laptop (8.14.3/8.14.3) with ESMTP id mAOJ0qPV002850;
	Mon, 24 Nov 2008 21:00:52 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Received: (from keramida@localhost)
	by kobe.laptop (8.14.3/8.14.3/Submit) id mAOJ0av2002846;
	Mon, 24 Nov 2008 21:00:36 +0200 (EET)
	(envelope-from keramida@freebsd.org)
From: Giorgos Keramidas <keramida@freebsd.org>
To: Tom Rhodes <trhodes@freebsd.org>
References: <492AE607.4020208@gmail.com>
	<20081124135107.06a8af26.trhodes@FreeBSD.org>
Date: Mon, 24 Nov 2008 21:00:35 +0200
In-Reply-To: <20081124135107.06a8af26.trhodes@FreeBSD.org> (Tom Rhodes's
	message of "Mon, 24 Nov 2008 13:51:07 -0500")
Message-ID: <87abbp3q5o.fsf@kobe.laptop>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-MailScanner-ID: mAOJ0rXx014412
X-Hellug-MailScanner: Found to be clean
X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached,
	score=-4.332, required 5, autolearn=not spam, ALL_TRUSTED -1.80,
	AWL 0.07, BAYES_00 -2.60)
X-Hellug-MailScanner-From: keramida@freebsd.org
X-Spam-Status: No
Cc: gabor@kovesdan.org, pgj@freebsd.org, doc@freebsd.org
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 <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 24 Nov 2008 19:17:06 -0000

On Mon, 24 Nov 2008 13:51:07 -0500, Tom Rhodes <trhodes@FreeBSD.org> wrote:
> On Mon, 24 Nov 2008 19:36:07 +0200
> Manolis Kiagias <sonic2000gr@gmail.com> wrote:
>> http://people.freebsd.org/~manolis/geom.txt

> This looks pretty good actually.  I would probably change the
> following:
>
> +      <example>
> +	<title>Labeling Your Boot Disk's Partitions</title>
>
> to:
>
> <title>Labeling Partitions on the Boot Disk</title>
>
> 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.