cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml
Tom Rhodes
trhodes at FreeBSD.org
Thu Jun 12 20:36:57 PDT 2003
On Thu, 12 Jun 2003 09:39:47 -0400
"Michael W . Lucas" <mwlucas at blackhelicopters.org> wrote:
>
> 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.
> >
This is a plus, however I already started working on mini-FAQ removal.
--
Tom Rhodes
More information about the cvs-all
mailing list