Date: Thu, 12 Jun 2003 23:32:51 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: "Michael W . Lucas" <mwlucas@blackhelicopters.org> Cc: cvs-all@FreeBSD.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml Message-ID: <20030612233251.1a466eb7.trhodes@FreeBSD.org> In-Reply-To: <20030612093947.A26907@blackhelicopters.org> 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> <20030612093947.A26907@blackhelicopters.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, 12 Jun 2003 09:39:47 -0400 "Michael W . Lucas" <mwlucas@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030612233251.1a466eb7.trhodes>