From owner-freebsd-doc Wed Oct 14 16:06:03 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id QAA14437 for freebsd-doc-outgoing; Wed, 14 Oct 1998 16:06:03 -0700 (PDT) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id QAA14383 for ; Wed, 14 Oct 1998 16:05:56 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.8.8/8.8.8) id XAA18186; Wed, 14 Oct 1998 23:22:26 +0100 (BST) (envelope-from nik) Message-ID: <19981014232226.04297@nothing-going-on.org> Date: Wed, 14 Oct 1998 23:22:26 +0100 From: Nik Clayton To: Eivind Eklund , "Robert A. Bruce" Cc: doc@FreeBSD.ORG, rab@pike.cdrom.com Subject: Re: Publishing the FreeBSD Handbook and FAQ References: <19981013133644.50562@follo.net> <199810131212.FAA13369@pike.cdrom.com> <19981013151548.43593@follo.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89.1i In-Reply-To: <19981013151548.43593@follo.net>; from Eivind Eklund on Tue, Oct 13, 1998 at 03:15:48PM +0200 Organization: Nik at home, where there's nothing going on Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Oct 13, 1998 at 03:15:48PM +0200, Eivind Eklund wrote: > On Tue, Oct 13, 1998 at 05:12:35AM -0700, Robert A. Bruce wrote: > > Different parts to the book have different styles, some parts are > > "folksy" while others are more formal. But I don't agree that this > > is necessarily a "problem" that needs to be fixed. As long as the > > information is technically correct, I don't think it is a big deal > > if the style varies from chapter to chapter. > > It depends on whether we want it to feel as a coherent work or as a > set of random collected writings. It is not very important, but it > would add a much more professional feel to it. The other thing we could do is split it out in to individual articles or HOWTOs. There's not a *great* deal of cross reference between the sections of the Handbook, and some of them (like the Printing or Security sections) could stand on their own very easily. I haven't seen any indication from the Linux camp of whether or not the HOWTO approach has proved to be more useful than one large document. FWIW I've also got a very fledgling markup guide for the DocBook version of the Handbook, written as I select particular elements for particular usages. It's not ready for release yet though :-( > > >(4) Contain relevant illustrations. > > > > Do you have a list of where illustrations are needed? Is there > > a standard way of putting illustrations into an SGML document? > > No and yes, respectively. Nik has details on how to insert > illustrations in his head (and I have them stored away on my hard > drive, and can probably dig them up if need be). Searching the -doc mailing list archive for the phrase 'inlinegraphic' will probably throw up most of what I've written on the subject. > IMO: The handbook really need somebody to read it before publishing it > :-) After the past few months, I probably know it better than anyone else :-) N -- C.R.F. Consulting -- we're run to make me richer. . . To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message