Date: Thu, 12 Jun 2003 11:04:44 +0100 From: Ceri Davies <setantae@submonkey.net> To: Nik Clayton <nik@freebsd.org> Cc: cvs-doc@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml Message-ID: <20030612100444.GA73927@submonkey.net> In-Reply-To: <20030612083321.GB19458@clan.nothing-going-on.org> References: <200306110036.h5B0aOkL049132@repoman.freebsd.org> <20030611083344.GA35406@HAL9000.homeunix.com> <20030611095020.B19916@blackhelicopters.org> <20030612083321.GB19458@clan.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, Jun 12, 2003 at 09:33:21AM +0100, Nik Clayton wrote:
> On Wed, Jun 11, 2003 at 09:50:20AM -0400, Michael W . Lucas wrote:
> > Short answer:
> >
> > The FAQ and the Handbook have different goals. The FAQ is supposed to
> > be brief and q&a oriented. Instead, it's full of brief tutorials that
> > need to be integrated into the Handbook.
> >
> > Stuff like "why did I upgrade to -stable and get -rc?" belongs in the
> > FAQ.
>
> I have a cunning plan, for which I currently have no time. It goes like
> this:
>
> Put a Q&A section at the end of every chapter in the Handbook (like the
> existing 2.11.4, but considerably expanded).
>
> As long as this section is appropriately marked up, we can then
> automatically generate the separate FAQ from its contents. We can then
> produce three documents:
>
> Handbook with integrated FAQ, one volume
>
> Handbook, no FAQ, one volume
>
> FAQ, one volume
This is a really nice idea, and I already know what it looks like, in my head.
I'll do some experimenting and let doc@ know what falls out.
Ceri
--
User: DO YOU ACCEPT JESUS CHRIST AS YOUR PERSONAL LORD AND SAVIOR?
Iniaes: Sure, I can accept all forms of payment.
-- www.chatterboxchallenge.com
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030612100444.GA73927>