Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 13 Jun 2001 16:58:07 -0700
From:      Murray Stokely <murray@FreeBSD.ORG>
To:        "Bruce A. Mah" <bmah@FreeBSD.ORG>
Cc:        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:  <20010613165807.A45984@meow.osd.bsdi.com>
In-Reply-To: <200106132316.f5DNG2365398@bmah-freebsd-0.cisco.com>; from bmah@FreeBSD.ORG on Wed, Jun 13, 2001 at 04:16:02PM -0700
References:  <XFMail.010613160240.jhb@FreeBSD.org> <200106132316.f5DNG2365398@bmah-freebsd-0.cisco.com>

index | next in thread | previous in thread | raw e-mail

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.

  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.

   - Murray

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message



help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010613165807.A45984>