From owner-cvs-doc@FreeBSD.ORG Thu Jun 12 03:04:47 2003 Return-Path: Delivered-To: cvs-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 907E537B401; Thu, 12 Jun 2003 03:04:47 -0700 (PDT) Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com [81.101.150.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7298743FAF; Thu, 12 Jun 2003 03:04:46 -0700 (PDT) (envelope-from setantae@submonkey.net) Received: from setantae by shrike.submonkey.net with local (Exim 4.20) id 19QOwm-000JFn-T2; Thu, 12 Jun 2003 11:04:44 +0100 Date: Thu, 12 Jun 2003 11:04:44 +0100 From: Ceri Davies To: Nik Clayton Message-ID: <20030612100444.GA73927@submonkey.net> Mail-Followup-To: Ceri Davies , Nik Clayton , "Michael W . Lucas" , Michael Lucas , doc-committers@freebsd.org, cvs-doc@freebsd.org, cvs-all@freebsd.org References: <200306110036.h5B0aOkL049132@repoman.freebsd.org> <20030611083344.GA35406@HAL9000.homeunix.com> <20030611095020.B19916@blackhelicopters.org> <20030612083321.GB19458@clan.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030612083321.GB19458@clan.nothing-going-on.org> User-Agent: Mutt/1.5.4i Sender: Ceri Davies cc: Michael Lucas cc: doc-committers@freebsd.org cc: "Michael W . Lucas" cc: cvs-all@freebsd.org cc: cvs-doc@freebsd.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 12 Jun 2003 10:04:48 -0000 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