Date: Tue, 13 Oct 1998 13:36:44 +0200 From: Eivind Eklund <eivind@yes.no> To: "Robert A. Bruce" <rab@cdrom.com>, doc@FreeBSD.ORG Subject: Re: Publishing the FreeBSD Handbook and FAQ Message-ID: <19981013133644.50562@follo.net> In-Reply-To: <199810080459.VAA15607@pike.cdrom.com>; from Robert A. Bruce on Wed, Oct 07, 1998 at 09:59:34PM -0700 References: <199810080459.VAA15607@pike.cdrom.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Oct 07, 1998 at 09:59:34PM -0700, Robert A. Bruce wrote:
> Howdy,
> We are planning to print books containing the FreeBSD Handbook and FAQ.
> We hope to send it to the printer in about 60 days. It takes about
> three weeks to prepare the plates, and print the books and about another
> month for the books to show up in the bookstores. So they should be
> hitting the shelves around January/February. That is about the same
> time FreeBSD 3.0.2 will be appearing (the first "-stable" release of
> the 3.X branch), so we would like to update the Handbook and FAQ so
> they document 3.X instead of 2.X. Does anybody have a guess about
> how much work this will take? Are there any other major changes that
> need to be made before these documents are published?
If you have some amount of manpower, it would be prudent to go through
the entire handbook and 'take notes' of what needs to be changed.
Ideally, the entire handbook should have a careful editor go through
and fix it to
(1) Have the same style throughout (language choices)
(2) Have each section organized in a 'build-up' fashion, starting from
almost no assumptions about what the user knows (or references to
what should have been read before) and building up to the full
gory details.
(3) Be fully marked up in DocBook instead of LinuxDoc.
(4) Contain relevant illustrations.
Nik Clayton <nik@freebsd.org> has started doing point 3 - I don't know
when he'll be finished or if he would be willing to do some of the
other tasks for money. Nik?
Eivind.
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?19981013133644.50562>