From owner-freebsd-doc@FreeBSD.ORG Thu Apr 10 07:30:26 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 E298737B401; Thu, 10 Apr 2003 07:30:26 -0700 (PDT) Received: from otter3.centtech.com (moat3.centtech.com [207.200.51.50]) by mx1.FreeBSD.org (Postfix) with ESMTP id 19EEA43F93; Thu, 10 Apr 2003 07:30:26 -0700 (PDT) (envelope-from anderson@centtech.com) Received: from centtech.com (electron.centtech.com [204.177.173.173]) by otter3.centtech.com (8.12.3/8.12.3) with ESMTP id h3AEUO56072278; Thu, 10 Apr 2003 09:30:24 -0500 (CDT) (envelope-from anderson@centtech.com) Message-ID: <3E957FF5.2000103@centtech.com> Date: Thu, 10 Apr 2003 09:30:13 -0500 From: Eric Anderson User-Agent: Mozilla/5.0 (X11; U; Linux i386; en-US; rv:1.0.1) Gecko/20020823 Netscape/7.0 X-Accept-Language: en-us, en MIME-Version: 1.0 To: Nik Clayton References: <20030408112740.A83997@blackhelicopters.org> <20030410141607.GB95802@clan.nothing-going-on.org> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit 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:30:27 -0000 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. Ooooo.. I like this a lot.. This seems like the "right way".. Eric -- ------------------------------------------------------------------ Eric Anderson Systems Administrator Centaur Technology Attitudes are contagious, is yours worth catching? ------------------------------------------------------------------