From owner-freebsd-doc Wed Mar 18 02:02:52 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id CAA19022 for freebsd-doc-outgoing; Wed, 18 Mar 1998 02:02:52 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from tyree.iii.co.uk (tyree.iii.co.uk [195.89.149.230]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id CAA18921 for ; Wed, 18 Mar 1998 02:02:43 -0800 (PST) (envelope-from nik@iii.co.uk) From: nik@iii.co.uk Received: from carrig.strand.iii.co.uk (carrig.strand.iii.co.uk [192.168.7.25]) by tyree.iii.co.uk (8.8.8/8.8.8) with ESMTP id KAA01006; Wed, 18 Mar 1998 10:02:40 GMT Received: (from nik@localhost) by carrig.strand.iii.co.uk (8.8.7/8.8.7) id KAA16503; Wed, 18 Mar 1998 10:02:40 GMT Message-ID: <19980318100240.53276@iii.co.uk> Date: Wed, 18 Mar 1998 10:02:40 +0000 To: Studded Cc: Docs Team Subject: Re: docbook conversion References: <350EEE0C.792C3D57@dal.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.85e In-Reply-To: <350EEE0C.792C3D57@dal.net>; from Studded on Tue, Mar 17, 1998 at 01:41:32PM -0800 Organization: interactive investor Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, Mar 17, 1998 at 01:41:32PM -0800, Studded wrote: > Assuming that we want the final product of the doc overhaul > to be in docbook format I think we can safely say that that's been decided upon. > If I understand the thing correctly, it will be easier to cut > and paste the bits we have into the final format if they are already in > docbook, yes? In theory, yes. However, at the moment DocBook and LinuxDoc can't coexist in the Handbook. If you have submissions to make to the Handbook *now* then they should be in LinuxDoc. I don't know how long the conversion process will take to complete, and I don't want to be a barrier to people who have updates they want to submit now. > Also, are plans being laid to convert the rest of the > docs on the www site too, like the FAQ and tutorials? Or will this be > fairly simple once we've got a method down for the handbook? The FAQ should be a natural extension of the Handbook, albeit with a few more bits of FAQ specific markup. This might be as simple as marking things up as: How do I do X? Do this, then do that, then do the other. Or it might get more involved and involve extending DocBook to something like How do I do X? Do this, then do that, then do the other. The first example can be mechanically converted to the second relatively simply, so the precise turn this takes isn't important (yet). As for the tutorials, in an ideal world they'll be converted as well. Of course, the final call on this is up to the authors of the tutorials. One of the things this will (should?) depend on is 2 style guides, one for authors and one for the people doing the markup (some of the time this will be the same person). I've started thinking about the markup style guide. Basically, this will (initially) consist of a series of Q and A explaining which markup should be used for which type of content. > Do we really want to make this change before 2.2.6 goes out? I see no way in which the migration will happen before 2.2.6 goes out. This is a non-issue. N -- Work: nik@iii.co.uk | FreeBSD + Perl + Apache Rest: nik@nothing-going-on.demon.co.uk | Remind me again why we need Play: nik@freebsd.org | Microsoft? To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message