From owner-freebsd-doc@FreeBSD.ORG Thu Apr 10 07:31:57 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2583E37B401; Thu, 10 Apr 2003 07:31:57 -0700 (PDT) Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3ECC943FA3; Thu, 10 Apr 2003 07:31:54 -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 h3AEVqDn097688; Thu, 10 Apr 2003 10:31:52 -0400 (EDT) (envelope-from mwlucas@blackhelicopters.org) Received: (from mwlucas@localhost) by blackhelicopters.org (8.12.8/8.12.8/Submit) id h3AEVqBX097687; Thu, 10 Apr 2003 10:31:52 -0400 (EDT) Date: Thu, 10 Apr 2003 10:31:52 -0400 From: "Michael W . Lucas" To: Nik Clayton Message-ID: <20030410103152.A97620@blackhelicopters.org> References: <20030408112740.A83997@blackhelicopters.org> <20030410141607.GB95802@clan.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20030410141607.GB95802@clan.nothing-going-on.org>; from nik@freebsd.org on Thu, Apr 10, 2003 at 03:16:07PM +0100 cc: doc@freebsd.org Subject: Re: Chainsawing the "Mouse" section of the FAQ X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 10 Apr 2003 14:31:57 -0000 On Thu, Apr 10, 2003 at 03:16:07PM +0100, Nik Clayton wrote: > On Wed, Apr 09, 2003 at 12:09:43PM -0700, Gary W. Swearingen wrote: > > "Michael W . Lucas" writes: > > > Any comments? > > > > Sure. Your considerable talents would be better spent on the FreeBSD > > Handbook. The FAQ should be a delete-only document. The sooner it rots > > away, the better. It's upkeep involves a duplication of effort that is > > worse than useless, as it tends to force FreeBSD users to have to hunt > > for information in an extra place for information that is not > > necessarily any more helpful than what the Handbook (or an Article) has > > (or should have). It's bad enough that the FDP has to duplicate so much > > of what xfree86.org has on mouse configuration, but that's given the > > existance and nature of "moused", I guess there's no alternative to > > that. > > Hmm. > > I quite like the idea of the FAQ merging in to the Handbook. > > Each chapter starts with a "Synopsis" section -- there's no reason why > they couldn't end with a "FAQ" section. If we wanted a separate FAQ > document, it could be generated by pulling out all the FAQ sections from > the Handbook. Didn't we hash this out a couple of years ago? :-) Personally, I think that the FAQ and the Handbook serve two different purposes. The Handbook is tutorial-oriented, the FAQ is for quick answers to basic questions. We need both. Integrating the two into the Handbook would be nice, if it gets maintained and someone can write the toolchain glue to pull the FAQ out. My energy for that sort of work is going into books for the forseeable future, however. In the meantime, I'm willing to help clean up the existing FAQ so that it's more useful and usable. ==ml -- Michael Lucas mwlucas@FreeBSD.org, mwlucas@BlackHelicopters.org http://www.BlackHelicopters.org/~mwlucas/ Absolute BSD: http://www.AbsoluteBSD.com/