Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 20 Jul 2004 09:11:21 -0400 (EDT)
From:      "Steve Bertrand" <iaccounts@ibctech.ca>
To:        "Nik Clayton" <nik@FreeBSD.org>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: Creating an Admin Handbook
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>

next in thread | previous in thread | raw e-mail | index | archive | help
> 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 ---
> .\._/_)
>




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?3157.209.167.16.15.1090329081.squirrel>