Date: Thu, 18 Nov 1999 08:01:42 +0000 From: Nik Clayton <nik@freebsd.org> To: Chris Costello <chris@calldei.com> Cc: Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG Subject: Re: FAQ notes. Message-ID: <19991118080141.A93488@kilt.nothing-going-on.org> In-Reply-To: <19991116130135.C548@holly.calldei.com>; from Chris Costello on Tue, Nov 16, 1999 at 01:01:35PM -0600 References: <19991115164146.I548@holly.calldei.com> <19991116080547.B92155@kilt.nothing-going-on.org> <19991116130135.C548@holly.calldei.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Nov 16, 1999 at 01:01:35PM -0600, Chris Costello wrote:
> On Tue, Nov 16, 1999, Nik Clayton wrote:
> > > setup/
> > > install.sgml
> > > kernelconfig.sgml
> > > hw.sgml
> > > troubleshooting.sgml
> >
> > <snip>
> >
> > What's wrong with the <chapter name>/chapter.sgml convention?
>
> Essentially each of those are different chapters. "Setup" is
> a <part> of the book.
The Handbook is organised the same way. The reasons for giving each chapter
it's own directory are
1. If you decide to move the chapter in to another part then it's
easy, you just shuffle the entity in the top level book.sgml. With
the approach you propose you'd need to do CVS repo work in order to
do this (and keep the tree consistent).
2. When we get around to adding images to the Handbook (or FAQ in this
case) it's very easy to keep the images with the chapter they are
used in.
3. [ There are more, but it's very early and I'm on the train, so I'm
not fully awake yet ]
N
--
If you want to imagine the future, imagine a tennis shoe stamping
on a penguin's face forever.
--- with apologies to George Orwell
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?19991118080141.A93488>