From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 13:33:54 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 5FFA316A4CE; Tue, 20 Jul 2004 13:33:54 +0000 (GMT) Received: from sccrmhc13.comcast.net (sccrmhc13.comcast.net [204.127.202.64]) by mx1.FreeBSD.org (Postfix) with ESMTP id E94B543D49; Tue, 20 Jul 2004 13:33:53 +0000 (GMT) (envelope-from zettel@acm.org) Received: from [192.168.0.6] (bgp966574bgs.derbrn01.mi.comcast.net[68.41.108.205]) by comcast.net (sccrmhc13) with ESMTP id <2004072013335301600bbupse>; Tue, 20 Jul 2004 13:33:53 +0000 From: Leonard Zettel To: freebsd-doc@freebsd.org Date: Tue, 20 Jul 2004 09:34:35 -0400 User-Agent: KMail/1.6.2 References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <3157.209.167.16.15.1090329081.squirrel@209.167.16.15> In-Reply-To: <3157.209.167.16.15.1090329081.squirrel@209.167.16.15> MIME-Version: 1.0 Content-Disposition: inline Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Message-Id: <200407200934.35643.zettel@acm.org> cc: Nik Clayton 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:33:54 -0000 On Tuesday 20 July 2004 09:11 am, Steve Bertrand wrote: > > 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? > If this outsider may be allowed $.02---- To my mind, an "admin" task is one performed primarily to help/mange users of the system other than one's self. =46rom a human/organizational viewpoint, this is indeed a fundamental dichotomy. At the same time, one could well question whether the tasks of handling FreeBSD really split up along those lines in any fundamental way. -LenZ- =20 > 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: > > > > =20 > > http://groups.google.com/groups?hl=3Den&lr=3D&ie=3DUTF-8&threadm=3D1999= 0405234615 > >.B6083%40catkin.nothing-going-on.org&rnum=3D9&prev=3D/groups%3Fq%3Dfreeb= sd%2Bh > >andbook%2Bsplit%2Bclayton%26hl%3Den%26lr%3D%26ie%3DUTF-8%26selm%3D199904= 05 > >234615.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 --- > > .\._/_) > > _______________________________________________ > freebsd-doc@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"