From owner-freebsd-doc Thu Jun 14 13:25: 4 2001 Delivered-To: freebsd-doc@freebsd.org Received: from sj-msg-core-4.cisco.com (sj-msg-core-4.cisco.com [171.71.163.10]) by hub.freebsd.org (Postfix) with ESMTP id 84B7437B410; Thu, 14 Jun 2001 13:24:37 -0700 (PDT) (envelope-from bmah@cisco.com) Received: from bmah-freebsd-0.cisco.com (bmah-freebsd-0.cisco.com [171.70.84.42]) by sj-msg-core-4.cisco.com (8.11.3/8.9.1) with ESMTP id f5EKOVk09204; Thu, 14 Jun 2001 13:24:31 -0700 (PDT) Received: (from bmah@localhost) by bmah-freebsd-0.cisco.com (8.11.3/8.11.3) id f5EKOOd75796; Thu, 14 Jun 2001 13:24:24 -0700 (PDT) (envelope-from bmah) Message-Id: <200106142024.f5EKOOd75796@bmah-freebsd-0.cisco.com> X-Mailer: exmh version 2.4+ 06/08/2001 with nmh-1.0.4 To: Valentino Vaschetto Cc: John Baldwin , Nik Clayton , freebsd-doc@FreeBSD.ORG, Chern Lee Subject: Re: Style/Grammar/Writing Guidelines In-Reply-To: References: Comments: In-reply-to Valentino Vaschetto message dated "Thu, 14 Jun 2001 13:00:02 -0700." From: "Bruce A. Mah" Reply-To: bmah@FreeBSD.ORG X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_-1982550245P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Thu, 14 Jun 2001 13:24:23 -0700 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 --==_Exmh_-1982550245P Content-Type: text/plain; charset=us-ascii If memory serves me right, Valentino Vaschetto wrote: > As do I. Murray, Chern and I are working to get the handbook ready for a > second printed version. We have the time and the ability to make the > handbook v2.0 really good, and it will :). I think that's great. Regardless of any differences of opinion we may have about writing style, I know you'll be fixing lots of technical errors, correcting misspellings, and making organizational improvements. This is a Good Thing (TM). > What would be nice is if people sent me (or -doc) things that SUCK in the > handbook, then I could make a list so Chern and I have some goals to > complete. Indexing is being taken care of.. loosly written chapters are > being rewritten/updated.. what else do you guys suggest? The installation chapter needs some work, in two ways. First, it includes a not-very-well-synched version of the hardware compatability list. I'd like to see this refer instead to the hardware lists that come with each release, rather than to try to duplicate the contents. The hardware list is release- and architecture-dependent, which makes keeping the version in the handbook synchronized to the version in the release documentation pretty much impossible. (Even if we were to try to keep it synched to, say, 4-STABLE, it's still a pain to keep it up to date.) Somewhat paradoxically, we could have some better synchronization between the rest of the installation chapter and the corresponding parts of the release documentation (I'm not sure in which direction the synchronization should go). The installation instructions don't change anywhere near as quickly, and it makes sense to have them in both paces. Just a thought..... Bruce. --==_Exmh_-1982550245P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: Exmh version 2.3.1+ 05/14/2001 iD8DBQE7KR132MoxcVugUsMRApteAKD+PnrRpwWwOWQrm86MuYtbAvyDmwCgkngM eU9ZPsLPoCHClj2XfvYhYzY= =g2Az -----END PGP SIGNATURE----- --==_Exmh_-1982550245P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message