Creating an Admin Handbook

[Leonard Zettel]

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.

From 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-
 
> 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%2Bh
> >andbook%2Bsplit%2Bclayton%26hl%3Den%26lr%3D%26ie%3DUTF-8%26selm%3D19990405
> >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 at freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe at freebsd.org"