Date: Wed, 13 Jun 2001 17:55:01 -0700 From: bmah@FreeBSD.ORG (Bruce A. Mah) To: Murray Stokely <murray@FreeBSD.ORG> Cc: "Bruce A. Mah" <bmah@FreeBSD.ORG>, John Baldwin <jhb@FreeBSD.ORG>, Eric Ogren <eogren@stanford.edu>, freebsd-doc@FreeBSD.ORG, Chern Lee <chern@meow.osd.bsdi.com> Subject: Re: Style/Grammar/Writing Guidelines Message-ID: <200106140055.f5E0t1F66094@bmah-freebsd-0.cisco.com> In-Reply-To: <20010613165807.A45984@meow.osd.bsdi.com> References: <XFMail.010613160240.jhb@FreeBSD.org> <200106132316.f5DNG2365398@bmah-freebsd-0.cisco.com> <20010613165807.A45984@meow.osd.bsdi.com>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] If memory serves me right, Murray Stokely wrote: > On Wed, Jun 13, 2001 at 04:16:02PM -0700, Bruce A. Mah wrote: > > Appropriate, yes, but not required, IMHO. I seem to remember from my > > technical writing class in college that this could be (is?) something > > of a religious issue. (Well, that's not what the instructor called it, > > Read through the handbook and then read through any other printed > technical publication. There is a huge difference and it becomes > apparent very quickly that the Handbook is nowhere near being ready > for shelf-exposure. We're not talking about minor grammatical nits > here (as your professor was), we're talking about very major ones. My issue was with style, not grammatical, structural, or factual problems. The latter conditions should be fixed. > We even have people who are willing to do the work of going through > each chapter and cleaning up the structure. We just need to come up > with some ground rules and guidelines about this sort of thing. I am > really shocked that there is any resistance to this since I've heard > so many grumbles about the very problem we're trying to fix. I am quite mystified that you and jhb interpreted my (implied) preference for an informal writing style as a lack of concern for the quality of the writing. Bruce. [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: Exmh version 2.3.1+ 05/14/2001 iD8DBQE7KAtk2MoxcVugUsMRArY+AKDQQTDy1IxdsiuspPvD5fNurHk05QCfZ6hv ueh8M8slwJA0BxXIN++OtEI= =Zp+U -----END PGP SIGNATURE-----home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200106140055.f5E0t1F66094>