From owner-freebsd-doc  Wed Jun 13 17: 6:31 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 B4BF337B438; Wed, 13 Jun 2001 17:06:26 -0700 (PDT)
	(envelope-from murray@meow.osd.bsdi.com)
Received: (from murray@localhost)
	by meow.osd.bsdi.com (8.11.3/8.11.2) id f5E06HH46312;
	Wed, 13 Jun 2001 17:06:17 -0700 (PDT)
	(envelope-from murray)
Date: Wed, 13 Jun 2001 17:06:17 -0700
From: Murray Stokely <murray@osd.bsdi.com>
To: Nik Clayton <nik@FreeBSD.ORG>
Cc: Chern Lee <chern@meow.osd.bsdi.com>, freebsd-doc@FreeBSD.ORG
Subject: Re: Style/Grammar/Writing Guidelines
Message-ID: <20010613170617.B45984@meow.osd.bsdi.com>
References: <Pine.BSF.4.31.0106131439170.43965-100000@meow.osd.bsdi.com> <0106140037160N.37769@clan.nothing-going-on.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <0106140037160N.37769@clan.nothing-going-on.org>; from nik@FreeBSD.ORG on Thu, Jun 14, 2001 at 12:37:16AM +0100
X-GPG-Key-ID: 1024D/0E451F7D
X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B  3CB5 B4D7 10A2 0E45 1F7D
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

On Thu, Jun 14, 2001 at 12:37:16AM +0100, Nik Clayton wrote:
>   1.  How many of the buyers / reviewers of the Handbook said that they
>       didn't like the tone.
> 
> vs.
> 
>   2.  How many of the buyers / reviewers said that they really, *really*
>       wanted to see a decent index?

  I don't see them as a trade off, but as two seperate issues that
both need to be addressed before a second edition can be published.

> expected to be, and we could be focussing our limited energies on efforts 
> that will be more useful to the readers (like, for example, an index).

  Speaking of an index Nik, do you mind committing one of our patches
to doc.docbook.mk?  I believe that yours is more elegant and correct
but they both work, and I'd like to see something in the tree that
allows us to move forward on the indexing front.

  Are you in favor of adding index entries into the Handbook in the
style that I added them to developers-handbook/secure?

	- Murray

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