From owner-freebsd-doc@FreeBSD.ORG Mon Jul 19 13:32:52 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 6DD8416A4CE; Mon, 19 Jul 2004 13:32:52 +0000 (GMT) Received: from electra.cse.Buffalo.EDU (electra.cse.Buffalo.EDU [128.205.32.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id EE8DF43D3F; Mon, 19 Jul 2004 13:32:51 +0000 (GMT) (envelope-from kensmith@cse.Buffalo.EDU) Received: from electra.cse.Buffalo.EDU (kensmith@localhost [127.0.0.1]) i6JDWpTH005992; Mon, 19 Jul 2004 09:32:51 -0400 (EDT) Received: (from kensmith@localhost) by electra.cse.Buffalo.EDU (8.12.10/8.12.9/Submit) id i6JDWpt4005991; Mon, 19 Jul 2004 09:32:51 -0400 (EDT) Date: Mon, 19 Jul 2004 09:32:50 -0400 From: Ken Smith To: Murray Stokely Message-ID: <20040719133250.GA5522@electra.cse.Buffalo.EDU> References: <20040719100354.GA90972@hub.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20040719100354.GA90972@hub.freebsd.org> User-Agent: Mutt/1.4.1i cc: doc@freebsd.org Subject: Re: Creating an Admin 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, 19 Jul 2004 13:32:52 -0000 On Mon, Jul 19, 2004 at 10:03:54AM +0000, Murray Stokely wrote: > I think the time has come to split up the Handbook. It has grown > unchecked for far too long and it has been several years since we last > moved chapters out of the Handbook (and into the Developers Handbook > in that case). > > The Handbook is currently organized as 5 distinct DocBook : > > * Getting Started > * Common Tasks > * System Administration > * Network Communication > * Appendices > > I would like to split the Handbook into a User Handbook and an > Administrator Handbook. The first two would belong to the > user handbook, the second two would belong to the > administrator handbook, and the appendices would be shared with both. I'm not against doing a split-up at all, and am definitely in favor of the general theme of the split - user docs versus admin docs. My only thought is that if time/energy is available perhaps a closer look at what goes where might be good. My general outlook on life is that "User Docs" == "Stuff that doesn't require root", "Admin Docs" == "Stuff that does require root (or the installation CD)". At first glance if I'm understanding the current split proposal things like "Installing FreeBSD", "Installing Applications", and "Configuring the FreeBSD Kernel" will wind up in the "Users' Docs". Given FreeBSD's history of being skewed somewhat towards developer type folks this isn't a fatal problem and I wouldn't object loudly if we do split it that way. But from a non-developer point of view it's possible those sorts of things should go in the Admin guide. Just my $0.01 (it's not worth $0.02... :-). -- Ken Smith - From there to here, from here to | kensmith@cse.buffalo.edu there, funny things are everywhere. | - Theodore Geisel |