From owner-freebsd-doc Thu May 13 14:48:50 1999 Delivered-To: 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 (Postfix) with ESMTP id 1605815200; Thu, 13 May 1999 14:48:42 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.2/8.9.2) id VAA76266; Thu, 13 May 1999 21:48:22 +0100 (BST) (envelope-from nik) Date: Thu, 13 May 1999 21:48:22 +0100 From: Nik Clayton To: Kevin Lo Cc: John Baldwin , nclayton@lehman.com, faq@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG Subject: Re: DocBook DTD's for 3.0 and 3.1 Message-ID: <19990513214822.A73230@catkin.nothing-going-on.org> References: <37392BC0.FE57FB8D@hello.com.tw> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <37392BC0.FE57FB8D@hello.com.tw>; from Kevin Lo on Wed, May 12, 1999 at 03:20:32PM +0800 Organization: Nik at home, where there's nothing going on Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, May 12, 1999 at 03:20:32PM +0800, Kevin Lo wrote: > IMO, I think we can start migrating it right now. > I'm currently writing new entries and looking at the order of entries > in their sections in the FAQ, reordering the sections in the proper order. OK. For the moment, please hold on converting the FAQ to DocBook. As you should've seen I've just sent out what is hopefully the final proposal for the doc/* directory structure. I'll give it a couple of days for the discussion about that to happen (more if it's an active discussion). Say, by Sunday. Assuming people are in agreement, I'll lay down the LINUXDOC_2_DOCBOOK* tags on the FAQ, and kickstart the conversion to DocBook. At the same time as this, the FAQ team can be revising the FAQ. However, remember the golden rule. Do not make content changes at the same time as you make formatting changes. Do them in two separate commits instead. This will make it much easier for myself and the language translation teams to track what you're doing. The FAQ conversion can then happen. The FAQ is a much simpler document than the Handbook, so it shouldn't take the year or so that the Handbook took :-) N -- There's some milk in the fridge about to go off. . . and there it goes. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message