From owner-cvs-all@FreeBSD.ORG Thu Jun 12 06:39:51 2003 Return-Path: Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8861637B401; Thu, 12 Jun 2003 06:39:51 -0700 (PDT) Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id 831DD43FE0; Thu, 12 Jun 2003 06:39:48 -0700 (PDT) (envelope-from mwlucas@blackhelicopters.org) Received: from blackhelicopters.org (mwlucas@localhost [127.0.0.1]) by blackhelicopters.org (8.12.8/8.12.8) with ESMTP id h5CDdlSW026928; Thu, 12 Jun 2003 09:39:47 -0400 (EDT) (envelope-from mwlucas@blackhelicopters.org) Received: (from mwlucas@localhost) by blackhelicopters.org (8.12.8/8.12.8/Submit) id h5CDdlsP026927; Thu, 12 Jun 2003 09:39:47 -0400 (EDT) Date: Thu, 12 Jun 2003 09:39:47 -0400 From: "Michael W . Lucas" To: Ceri Davies , Nik Clayton , Michael Lucas , doc-committers@freebsd.org, cvs-doc@freebsd.org, cvs-all@freebsd.org Message-ID: <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> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20030612100444.GA73927@submonkey.net>; from setantae@submonkey.net on Thu, Jun 12, 2003 at 11:04:44AM +0100 Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/faq book.sgml X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 12 Jun 2003 13:39:53 -0000 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/