cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml

[Michael W . Lucas]

Great idea, but I'm glad someone else can do the work, as I cannot...

On Thu, Jun 12, 2003 at 11:04:44AM +0100, Ceri Davies wrote:
> 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

-- 
Michael Lucas		mwlucas at FreeBSD.org, mwlucas at BlackHelicopters.org
http://www.BlackHelicopters.org/~mwlucas/

           Absolute OpenBSD:   http://www.AbsoluteOpenBSD.com/