Date: Mon, 29 May 2006 08:17:39 +0200 (CEST) From: "Remko Lodder" <remko@FreeBSD.org> To: "Marc Fonvieille" <blackend@FreeBSD.org> 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 Message-ID: <46833.145.221.52.72.1148883459.squirrel@webmail.evilcoder.org> In-Reply-To: <20060529060805.GD79291@abigail.blackend.org> References: <200605281833.k4SIXQ0S080387@repoman.freebsd.org> <20060528193758.GC79291@abigail.blackend.org> <4479FE1E.8030304@FreeBSD.org> <20060529060805.GD79291@abigail.blackend.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, May 29, 2006 08:08, Marc Fonvieille wrote: > 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 > I only changed it there because i was actively translating that part and saw the text, and we tend to only change things when you are working on it anyway. But this is not helping us in the discussion about why I did what. Lets rather talk about how we can go on with this in such a way that it will be clear for anyone to follow. Thanks. -- Kind regards, Remko Lodder ** remko@elvandar.org FreeBSD ** remko@FreeBSD.org /* Quis Custodiet ipsos custodes */
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?46833.145.221.52.72.1148883459.squirrel>