From owner-freebsd-doc Tue Mar 17 13:41:37 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id NAA26948 for freebsd-doc-outgoing; Tue, 17 Mar 1998 13:41:37 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from dt050n33.san.rr.com (@dt050n33.san.rr.com [204.210.31.51]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id NAA26934 for ; Tue, 17 Mar 1998 13:41:34 -0800 (PST) (envelope-from Studded@dal.net) Received: from dal.net (Studded@localhost [127.0.0.1]) by dt050n33.san.rr.com (8.8.8/8.8.8) with ESMTP id NAA20644 for ; Tue, 17 Mar 1998 13:41:32 -0800 (PST) (envelope-from Studded@dal.net) Message-ID: <350EEE0C.792C3D57@dal.net> Date: Tue, 17 Mar 1998 13:41:32 -0800 From: Studded Organization: Triborough Bridge & Tunnel Authority X-Mailer: Mozilla 4.04 [en] (X11; I; FreeBSD 2.2.6-BETA-0316 i386) MIME-Version: 1.0 To: Docs Team Subject: docbook conversion Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org I've read the plan for converting the handbook to docbook format. Nik has certainly done a lot of work on this and I think he should be applauded. Assuming that we want the final product of the doc overhaul to be in docbook format (and that certainly seems to be a reasonable assumption) I don't see any problems in going ahead with this as planned. 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? 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 next set of questions I have relate to the timing of the changes. Do we really want to make this change before 2.2.6 goes out? What would the advantages to that be? It seems to me that time effort and energy would be better served by tightening up and correcting the text we have, shipping 2.2.6 with all of the docs in the old format and make the next release the first to utilize the new. Overall I think that waiting to make the conversion will result in the least headaches and the best overall product. Doug -- *** Chief Operations Officer, DALnet IRC network *** *** Proud operator, designer and maintainer of the world's largest *** Internet Relay Chat server. 5,328 clients and still growing. *** Try spider.dal.net on ports 6662-4 (Powered by FreeBSD) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message