From owner-freebsd-doc Tue Oct 13 04:37:07 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id EAA12991 for freebsd-doc-outgoing; Tue, 13 Oct 1998 04:37:07 -0700 (PDT) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from ns1.yes.no (ns1.yes.no [195.204.136.10]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id EAA12980 for ; Tue, 13 Oct 1998 04:37:04 -0700 (PDT) (envelope-from eivind@bitbox.follo.net) Received: from bitbox.follo.net (bitbox.follo.net [195.204.143.218]) by ns1.yes.no (8.9.1a/8.9.1) with ESMTP id NAA03156; Tue, 13 Oct 1998 13:36:45 +0200 (CEST) Received: (from eivind@localhost) by bitbox.follo.net (8.8.8/8.8.6) id NAA18088; Tue, 13 Oct 1998 13:36:44 +0200 (MET DST) Message-ID: <19981013133644.50562@follo.net> Date: Tue, 13 Oct 1998 13:36:44 +0200 From: Eivind Eklund To: "Robert A. Bruce" , doc@FreeBSD.ORG Subject: Re: Publishing the FreeBSD Handbook and FAQ References: <199810080459.VAA15607@pike.cdrom.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89.1i In-Reply-To: <199810080459.VAA15607@pike.cdrom.com>; from Robert A. Bruce on Wed, Oct 07, 1998 at 09:59:34PM -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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 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