From owner-cvs-doc@FreeBSD.ORG Thu Jun 12 20:36:56 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 B68B537B401; Thu, 12 Jun 2003 20:36:56 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id CBCD643F85; Thu, 12 Jun 2003 20:36:55 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com ([192.168.0.5]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h5D3ae99040054; Thu, 12 Jun 2003 23:36:41 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 12 Jun 2003 23:32:51 -0400 From: Tom Rhodes To: "Michael W . Lucas" 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> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: setantae@submonkey.net cc: cvs-doc@FreeBSD.org cc: mwlucas@FreeBSD.org cc: doc-committers@FreeBSD.org cc: nik@FreeBSD.org cc: cvs-all@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: Fri, 13 Jun 2003 03:36:57 -0000 On Thu, 12 Jun 2003 09:39:47 -0400 "Michael W . Lucas" 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