From owner-freebsd-doc@FreeBSD.ORG Fri Dec 3 01:33:01 2004 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 F060816A4CE; Fri, 3 Dec 2004 01:33:00 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id D3FEA43D1F; Fri, 3 Dec 2004 01:33:00 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 8D46C148DB; Thu, 2 Dec 2004 19:33:00 -0600 (CST) Date: Thu, 2 Dec 2004 19:33:00 -0600 (CST) From: Mark Linimon X-X-Sender: linimon@pancho To: Tom Rhodes In-Reply-To: <20041202132637.2e47744b@localhost> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: FreeBSD-doc@FreeBSD.org Subject: Re: Merging the FAQ -> handbook, build time options, proof ofconcept patch 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: Fri, 03 Dec 2004 01:33:01 -0000 I'm running very short of cycles at the moment so the following is pretty rough ... Here's my idea for what the FAQ ought to look like once a) the various things that Tom is talking about are moved and b) a few more things become standalone Articles (e.g. the really nice PPP writeup -- it's great, but having it in the middle of the FAQ means that it 1) gets buried and 2) makes the FAQ too long for anyone but the most dedicated FreeBSD fanatic to make it through). It's still too long by about 2x but it's a damned sight closer. Most of the duplicated material is removed. All the "what is it/where is it/how do I get it" material remains. Some of the "why is it the way it is" information remains but it needs to be reshuffled. The Table Of Contents probably ought to be more like 1 Introduction 2 Documentation and Support 3 Hardware compatibility 3.1 Architectures and processors 3.2 Peripherals and add-on cards 4 Installation 5 Troubleshooting 6 System Configuration and Administration [fold in Networking, Security] 7 Commercial Applications 8 User Applications 9 The X Window System and Virtual Consoles 10 Miscellaneous Questions 11 The FreeBSD Funnies 12 Advanced Topics 13 Acknowledgments Bibliography The prototype is at http://www.lonesome.com/FreeBSD_doc/en_US.ISO8859-1/books/faq/index.html. mcl