Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 13 May 1999 21:48:22 +0100
From:      Nik Clayton <nik@nothing-going-on.demon.co.uk>
To:        Kevin Lo <kevlo@hello.com.tw>
Cc:        John Baldwin <jobaldwi@vt.edu>, 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>
In-Reply-To: <37392BC0.FE57FB8D@hello.com.tw>; from Kevin Lo on Wed, May 12, 1999 at 03:20:32PM %2B0800
References:  <XFMail.990512013215.jobaldwi@vt.edu> <37392BC0.FE57FB8D@hello.com.tw>

next in thread | previous in thread | raw e-mail | index | archive | help
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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990513214822.A73230>