Date: Sat, 16 Jun 2001 15:19:18 +0100 From: Nik Clayton <nik@FreeBSD.org> To: Murray Stokely <murray@osd.bsdi.com>, 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: <0106161519180Q.01838@clan.nothing-going-on.org> In-Reply-To: <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> <20010613170617.B45984@meow.osd.bsdi.com>
next in thread | previous in thread | raw e-mail | index | archive | help
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
On Thursday 14 June 2001 1:06 am, Murray Stokely wrote:
> 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.
No question. But I'd like to see some priorities.
As a general principle, if WRS are planning on doing a second edition, it
would also be good to know what the feedback was from the first edition,
whether or not there's a "fix list" of things to do, and so on (I see
you've committed stuff from Chern already, which is good).
I'd also like to know timescales, and to make sure that WRS know what's up
and coming in the Handbook -- for example, Randy's install preview, that
sort of thing.
Maybe a meeting at Usenix would be a good idea?
> > 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.
Mail loss means I don't have the patches to hand. I think I've
reimplemented it from scratch, but I could be wrong. It was certainly
enough to add
<!ENTITY index SYSTEM "index.sgml">
to the top of book.sgml, and
&index;
to the bottom -- the generated index looked fine, and there didn't seem to
be a problem when generating different formats.
> Are you in favor of adding index entries into the Handbook in the
> style that I added them to developers-handbook/secure?
Works for me.
N
- --
FreeBSD: The Power to Serve http://www.freebsd.org/
FreeBSD Documentation Project http://www.freebsd.org/docproj/
--- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 ---
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (FreeBSD)
Comment: For info see http://www.gnupg.org
iEYEARECAAYFAjsrauYACgkQk6gHZCw343VQWQCeJr/AhWkS2PiYpJnEb1jsc3NR
ZugAnRPdAllTrLIvNy0Poh9pL3C5Mia7
=BOL0
-----END PGP SIGNATURE-----
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?0106161519180Q.01838>