From owner-cvs-doc@FreeBSD.ORG Sun May 28 19:46:43 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 4E6BD16B494; Sun, 28 May 2006 19:46:43 +0000 (UTC) (envelope-from remko@freebsd.org) Received: from caelis.elvandar.org (caelis.elvandar.org [217.148.169.59]) by mx1.FreeBSD.org (Postfix) with ESMTP id 36C1D43D86; Sun, 28 May 2006 19:46:40 +0000 (GMT) (envelope-from remko@freebsd.org) Received: from localhost (caelis.elvandar.org [217.148.169.59]) by caelis.elvandar.org (Postfix) with ESMTP id 4626092FD60; Sun, 28 May 2006 21:46:39 +0200 (CEST) Received: from caelis.elvandar.org ([217.148.169.59]) by localhost (caelis.elvandar.org [217.148.169.59]) (amavisd-new, port 10024) with ESMTP id 84348-10; Sun, 28 May 2006 21:46:38 +0200 (CEST) Message-ID: <4479FE1E.8030304@FreeBSD.org> Date: Sun, 28 May 2006 21:46:38 +0200 From: Remko Lodder User-Agent: Thunderbird 1.5.0.2 (Macintosh/20060308) MIME-Version: 1.0 To: Marc Fonvieille References: <200605281833.k4SIXQ0S080387@repoman.freebsd.org> <20060528193758.GC79291@abigail.blackend.org> In-Reply-To: <20060528193758.GC79291@abigail.blackend.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: by the elvandar.org maildomain Cc: doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org, cvs-all@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 Reply-To: remko@FreeBSD.org 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: Sun, 28 May 2006 19:46:49 -0000 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. Good to have this 'discussion started' ;) cheers, remko -- Kind regards, Remko Lodder ** remko@elvandar.org FreeBSD ** remko@FreeBSD.org /* Quis custodiet ipsos custodes */