From owner-freebsd-doc@FreeBSD.ORG  Tue Jul 20 10:13:24 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 42BC316A4CE; Tue, 20 Jul 2004 10:13:24 +0000 (GMT)
Received: from volginfo.ru (ns.volginfo.ru [217.23.84.100])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 77EE843D58; Tue, 20 Jul 2004 10:13:23 +0000 (GMT)
	(envelope-from den@FreeBSD.org)
Received: from FreeBSD.org (llp-13.vistcom.ru [217.23.84.68])
	by volginfo.ru (Postfix) with ESMTP
	id 379A72010; Tue, 20 Jul 2004 14:13:24 +0400 (MSD)
Message-ID: <40FCF042.6020102@FreeBSD.org>
Date: Tue, 20 Jul 2004 14:13:22 +0400
From: Denis Peplin <den@FreeBSD.org>
User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.6) Gecko/20040205
X-Accept-Language: ru, en-us, en
MIME-Version: 1.0
To: Ken Smith <kensmith@cse.Buffalo.EDU>
References: <20040719100354.GA90972@hub.freebsd.org>
	<20040719133250.GA5522@electra.cse.Buffalo.EDU>
In-Reply-To: <20040719133250.GA5522@electra.cse.Buffalo.EDU>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
cc: 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 <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 20 Jul 2004 10:13:24 -0000

Hello!

Ken Smith 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.  It has grown
>>unchecked for far too long and it has been several years since we last
>>moved chapters out of the Handbook (and into the Developers Handbook
>>in that case).
>>
>>The Handbook is currently organized as 5 distinct DocBook <parts> :
>>
>>* Getting Started
>>* Common Tasks
>>* System Administration
>>* Network Communication
>>* Appendices
>>
>>I would like to split the Handbook into a User Handbook and an
>>Administrator Handbook.  The first two <parts> would belong to the
>>user handbook, the second two <parts> would belong to the
>>administrator handbook, and the appendices would be shared with both.
> 
> 
> I'm not against doing a split-up at all, and am definitely in favor
> of the general theme of the split - user docs versus admin docs.
> 
> My only thought is that if time/energy is available perhaps a closer look
> at what goes where might be good.  My general outlook on life is that
> "User Docs" == "Stuff that doesn't require root", "Admin Docs" == "Stuff
> that does require root (or the installation CD)".

OK, let start voting!
Handbook split will probably require some additional docs moving,
for example i vote for:
"Configuring the FreeBSD Kernel" -
move to admins section (nowadays not every user require this - for example,
on my FreeBSD desktop i  have GENERIC kernel).
Most content from
"Linux Binary Compatibility" is advanced topic too (if i want to install
common Linux binary, i will install it from ports).

And for users handbook:
many sections from "Configuration and Tuning",
16.6 Creating and Using Optical Media (CDs),
16.7 Creating and Using Optical Media (DVDs),
21.2 Using User PPP
and this list is not near to complete....