Date: Thu, 12 Jun 2003 09:39:47 -0400 From: "Michael W . Lucas" <mwlucas@blackhelicopters.org> To: Ceri Davies <setantae@submonkey.net>, Nik Clayton <nik@freebsd.org>, Michael Lucas <mwlucas@freebsd.org>, doc-committers@freebsd.org, cvs-doc@freebsd.org, cvs-all@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml Message-ID: <20030612093947.A26907@blackhelicopters.org> In-Reply-To: <20030612100444.GA73927@submonkey.net>; from setantae@submonkey.net on Thu, Jun 12, 2003 at 11:04:44AM %2B0100 References: <200306110036.h5B0aOkL049132@repoman.freebsd.org> <20030611083344.GA35406@HAL9000.homeunix.com> <20030611095020.B19916@blackhelicopters.org> <20030612083321.GB19458@clan.nothing-going-on.org> <20030612100444.GA73927@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
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@FreeBSD.org, mwlucas@BlackHelicopters.org http://www.BlackHelicopters.org/~mwlucas/ Absolute OpenBSD: http://www.AbsoluteOpenBSD.com/
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030612093947.A26907>