Creating an Admin Handbook

[Steve Bertrand]

> 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 ---
> .\._/_)
>