From owner-freebsd-doc@FreeBSD.ORG Mon Dec 6 14:37:56 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 9904416A4CE; Mon, 6 Dec 2004 14:37:56 +0000 (GMT) Received: from otter3.centtech.com (moat3.centtech.com [207.200.51.50]) by mx1.FreeBSD.org (Postfix) with ESMTP id E9EA743D62; Mon, 6 Dec 2004 14:37:55 +0000 (GMT) (envelope-from anderson@centtech.com) Received: from [10.177.171.220] (neutrino.centtech.com [10.177.171.220]) by otter3.centtech.com (8.12.3/8.12.3) with ESMTP id iB6EboOJ010164; Mon, 6 Dec 2004 08:37:50 -0600 (CST) (envelope-from anderson@centtech.com) Message-ID: <41B46EBA.6060907@centtech.com> Date: Mon, 06 Dec 2004 08:37:46 -0600 From: Eric Anderson User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.7.3) Gecko/20041110 X-Accept-Language: en-us, en MIME-Version: 1.0 To: Giorgos Keramidas References: <20041205114254.GD23252@clan.nothing-going-on.org> <41B3617B.3080507@centtech.com> <20041206121210.GA2166@orion.daedalusnetworks.priv> In-Reply-To: <20041206121210.GA2166@orion.daedalusnetworks.priv> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit cc: doc@freebsd.org cc: Nik Clayton Subject: Re: Time for a Network Handbook? 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: Mon, 06 Dec 2004 14:37:56 -0000 Giorgos Keramidas wrote: > On 2004-12-05 13:28, Eric Anderson wrote: > >>Nik Clayton wrote: >> >>>Anybody got any strong feelings about moving the existing "Network >>>Communication" out of the Handbook, and using it to seed a new >>>FreeBSD Networking Handbook? >> >>What's the reasoning behind it? I like it in the Handbook personally - >>it fits with the rest of the book. > > > It moves us one step closer to the holy grail of a "handbook collection" > -- a collection of books that will cover more specific topics, i.e.: > > User's Handbook > Admin's Handbook > Programmer's Handbook > System Programmer's Handbook > Networking Handbook > > etc. :-) Ok - I like that idea - but I'd like to say that some work needs to be done on the "Documentation" page (http://www.freebsd.org/docs.html). From the main FreeBSD page, if you click on Documentation, it brings you to this page. I think the page isn't really too intuitive, and should be reorganized to make it a bit simpler to navigate. It's a small thing, but I've watched two people glance right down the page and miss ALL the handbooks already there, because it's under a heading called "Books" and they are thinking that means something you can buy at a bookstore. Also - I think it might be handy to have the 'Handbook' link on the main site then point to a 'Handbooks' page, that has all the handbooks on it, with a short paragraph underneath each one describing it's intent or contents. Just some thoughts.. Eric -- ------------------------------------------------------------------------ Eric Anderson Sr. Systems Administrator Centaur Technology When in doubt, mumble; when in trouble, delegate; when in charge, ponder ------------------------------------------------------------------------