From owner-cvs-doc@FreeBSD.ORG Mon May 29 06:08:08 2006 Return-Path: X-Original-To: cvs-doc@FreeBSD.org Delivered-To: cvs-doc@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6777616A4DA; Mon, 29 May 2006 06:08:08 +0000 (UTC) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8B70843D48; Mon, 29 May 2006 06:08:07 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) by abigail.blackend.org (8.13.4/8.13.3) with ESMTP id k4T685TA003059; Mon, 29 May 2006 08:08:05 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.13.4/8.13.3/Submit) id k4T685j8003058; Mon, 29 May 2006 08:08:05 +0200 (CEST) (envelope-from marc) Date: Mon, 29 May 2006 08:08:05 +0200 From: Marc Fonvieille To: Remko Lodder Message-ID: <20060529060805.GD79291@abigail.blackend.org> References: <200605281833.k4SIXQ0S080387@repoman.freebsd.org> <20060528193758.GC79291@abigail.blackend.org> <4479FE1E.8030304@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4479FE1E.8030304@FreeBSD.org> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.11-STABLE User-Agent: Mutt/1.5.9i Cc: doc-committers@FreeBSD.org, Marc Fonvieille , cvs-all@FreeBSD.org, cvs-doc@FreeBSD.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/disks chapter.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 29 May 2006 06:08:08 -0000 On Sun, May 28, 2006 at 09:46:38PM +0200, Remko Lodder wrote: > Marc Fonvieille wrote: > >On Sun, May 28, 2006 at 06:33:25PM +0000, Remko Lodder wrote: > >>remko 2006-05-28 18:33:25 UTC > >> > >> FreeBSD doc repository > >> > >> Modified files: > >> en_US.ISO8859-1/books/handbook/disks chapter.sgml > >> Log: > >> Update the DVD-RAM section a bit. This avoids the usage of "you", "we" > >> and things like that, which is consistent with the rest of the > >> documention. > >> > >[...] > > > >Using grep on chapter.sgml gives about 250 "you" and 35 "we" > >(in the related section: 29 "you" and 8 "we"); I think there's a > >confusion with the use of "I" or other familiar wordings. > > > >You changed the active voice of "You have to enable DMA access for ATAPI > >devices, this can be done in adding the following line to the > >/boot/loader.conf file:" to the passive voice, Ok[1] but you have to > >also change the same sentence which appears at the beginning of a > >previous subsection (17.7.2) to be really consistent. > > > >Marc > > > >[1] Many persons think the passive voice should be replaced with active > >voice, but no one is really affirmative on this point, an interesting > >point of view can be found at http://www.spinellis.gr/blog/20060316/ > >(dds@ blog). > > OK, i am fine with boths ways (although you can see my preference > with this commit): do you think we can workout something for doc@ > so that we have a guideline or something? The one thing that I do > want to have is having documents being consistent with eachother in > the way they address people etc. As I previously said there were 2 instances of the same sentence on that page. I just wonder why you changed one and not the other since you stated you did it for consistency. Marc