From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 13:11:23 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 CA4F916A4CE for ; Tue, 20 Jul 2004 13:11:23 +0000 (GMT) Received: from mbox.ibctech.ca (dev.eagle.ca [209.167.58.10]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0058143D39 for ; Tue, 20 Jul 2004 13:11:22 +0000 (GMT) (envelope-from iaccounts@ibctech.ca) Received: (qmail 78059 invoked by uid 1002); 20 Jul 2004 13:11:22 -0000 Received: from iaccounts@ibctech.ca by pearl.ibctech.ca by uid 89 with qmail-scanner-1.22 (clamscan: 0.73. spamassassin: 2.63. Clear:RC:1(127.0.0.1):. Processed in 1.037636 secs); 20 Jul 2004 13:11:22 -0000 Received: from unknown (HELO webmail.ibctech.ca) (127.0.0.1) by localhost.ibctech.ca with SMTP; 20 Jul 2004 13:11:20 -0000 Received: from 209.167.16.15 (SquirrelMail authenticated user steve@ibctech.ca); by webmail.ibctech.ca with HTTP; Tue, 20 Jul 2004 09:11:21 -0400 (EDT) Message-ID: <3157.209.167.16.15.1090329081.squirrel@209.167.16.15> In-Reply-To: <20040720103432.GA64597@clan.nothing-going-on.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> Date: Tue, 20 Jul 2004 09:11:21 -0400 (EDT) From: "Steve Bertrand" To: "Nik Clayton" User-Agent: SquirrelMail/1.4.3a X-Mailer: SquirrelMail/1.4.3a MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 (Normal) Importance: Normal cc: freebsd-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: Tue, 20 Jul 2004 13:11:23 -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. > > &deja.vu; > > Yes, with a reservation. Specifically, is there a description > anywhere of what constitutes a user task and what's an admin task? Is there a way to compile statistics on the most frequently asked user-type questions, and the most common admin-type questions out of the mailing lists? Is there any way to poll our lists/web visitors and ask THEM what THEY think constitutes a user or admin section? Maybe the users/admins of FreeBSD would provide the best feedback and insight to the doc-team so there is some sort of consensus on it. Just my $.02 Steve > > Looking over the existing Handbook, all of the following (notionally in > the 'user' section) strike me as being admin tasks: > > Chapter 4 - Installing Applications > Chapter 8 - Configuring the FreeBSD Kernel > Chapter 10 - Linux Binary Compatability > > Last time this sort of thing came up, we discussed making the split > along task-oriented lines, potentially leading to several smaller > handbooks, rather than the two books that you're suggesting. > > This has been on the backburner for a *long* time: > > http://groups.google.com/groups?hl=en&lr=&ie=UTF-8&threadm=19990405234615.B6083%40catkin.nothing-going-on.org&rnum=9&prev=/groups%3Fq%3Dfreebsd%2Bhandbook%2Bsplit%2Bclayton%26hl%3Den%26lr%3D%26ie%3DUTF-8%26selm%3D19990405234615.B6083%2540catkin.nothing-going-on.org%26rnum%3D9 > > So consider this one last stab at getting someone to implement that > idea. Failing that, your willingness to do the work you've outlined > trumps my kvetching from the sidelines :-) > > N > -- > FreeBSD: The Power to Serve http://www.freebsd.org/ > (__) > FreeBSD Documentation Project http://www.freebsd.org/docproj/ > \\\'',) > \/ > \ ^ > --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- > .\._/_) >