From owner-freebsd-doc@FreeBSD.ORG  Mon Jul 12 16:53:41 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 709A416A4D2
	for <doc@freebsd.org>; Mon, 12 Jul 2004 16:53:41 +0000 (GMT)
Received: from eborcom.com (dsl-62-3-122-102.zen.co.uk [62.3.122.102])
	by mx1.FreeBSD.org (Postfix) with SMTP id 3277643D49
	for <doc@freebsd.org>; Mon, 12 Jul 2004 16:53:40 +0000 (GMT)
	(envelope-from tom@FreeBSD.org)
Received: (qmail 16402 invoked by uid 1001); 12 Jul 2004 16:53:38 -0000
Date: Mon, 12 Jul 2004 17:53:38 +0100
From: Tom Hukins <tom@FreeBSD.org>
To: Murray Stokely <murray@FreeBSD.org>
Message-ID: <20040712165338.GA16218@eborcom.com>
Mail-Followup-To: Tom Hukins <tom@FreeBSD.org>,
	Murray Stokely <murray@FreeBSD.org>, doc@freebsd.org,
	doceng@freebsd.org
References: <20040712100256.GB3948@hub.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20040712100256.GB3948@hub.freebsd.org>
User-Agent: Mutt/1.4.1i
cc: doceng@freebsd.org
cc: doc@freebsd.org
Subject: Re: Split of Advanced Networking chapter of 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: Mon, 12 Jul 2004 16:53:41 -0000

On Mon, Jul 12, 2004 at 10:02:56AM +0000, Murray Stokely wrote:
> The Advanced Networking chapter of the Handbook is almost 100 pages
> and is certainly too unwieldy in it's current form.

Agreed.

> I would like to split out the network server configuration sections
> into a separate chapter called 'Network Servers'.  The new chapter
> would contain the sections on NFS, NIS/YP, DHCP, DNS, NTP, and inetd.

I've been concerned for a while about the prevalance of TLAs here.
Sure, most users will know what DNS does, but maybe we should make
section titles more helpful by using something like:
- Networked File Sharing (NFS)
- Networked Account Sharing (NIS)
- Automatic Network Configuration (DHCP)
- Host and Domain Name Configuration (DNS)
- Clock Synchronization (NTP)

This way, users looking through the book's contents will have a
clearer idea of what different sections are about.

Alternatively, this might be solved through adding index terms.
Opinions?  If I don't hear any objections, I'll commit something along
these lines.

Regardless, I think the work Murray has done is a useful improvement.

Tom