From owner-freebsd-doc Wed Jun 13 16: 2:52 2001 Delivered-To: freebsd-doc@freebsd.org Received: from meow.osd.bsdi.com (meow.osd.bsdi.com [204.216.28.88]) by hub.freebsd.org (Postfix) with ESMTP id C875B37B407 for ; Wed, 13 Jun 2001 16:02:49 -0700 (PDT) (envelope-from jhb@FreeBSD.org) Received: from laptop.baldwin.cx (john@jhb-laptop.osd.bsdi.com [204.216.28.241]) by meow.osd.bsdi.com (8.11.3/8.11.2) with ESMTP id f5DN2X145129; Wed, 13 Jun 2001 16:02:33 -0700 (PDT) (envelope-from jhb@FreeBSD.org) Message-ID: X-Mailer: XFMail 1.4.0 on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: Date: Wed, 13 Jun 2001 16:02:40 -0700 (PDT) From: John Baldwin To: Eric Ogren Subject: RE: Style/Grammar/Writing Guidelines Cc: freebsd-doc@FreeBSD.org, Chern Lee Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On 13-Jun-01 Eric Ogren wrote: > Speaking as someone who's contributed a decent amount of stuff to the > Handbook (in fact, I'm pretty sure that the passage you quoted was revised > by me about a year ago), I don't particularly see a problem with the tone. > Admittedly, I'm biased, but I don't really think of the Handbook as a > technical, formal document -- I think of it as more of a "Here's how you use > FreeBSD." The majority of the chapters are targeted towards more > non-technical users, and as such, I think the fact that a lot of the > handbook has an informal tone is actually a good thing. I find "You may need > to prepare some floppy disks" just a lot nicer to read than "The first step > to installing FreeBSD is to create the kern and mfsroot floppy disks." > Again, I'm biased, since I much prefer to write informally, but that's my 2 > cents. Recall that the Handbook is formally published as an actual book that will hopefuly be put on the shelf at your local bookstore. With that in mind, using formal English is quite appropriate. -- John Baldwin -- http://www.FreeBSD.org/~jhb/ PGP Key: http://www.baldwin.cx/~john/pgpkey.asc "Power Users Use the Power to Serve!" - http://www.FreeBSD.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message