From owner-freebsd-doc@FreeBSD.ORG Mon Dec 6 19:21:11 2004 Return-Path: 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 112CC16A4E4; Mon, 6 Dec 2004 19:21:11 +0000 (GMT) Received: from jc.ngo.org.uk (jc.ngo.org.uk [69.55.225.33]) by mx1.FreeBSD.org (Postfix) with ESMTP id A911A43D6A; Mon, 6 Dec 2004 19:21:10 +0000 (GMT) (envelope-from nik@crf-consulting.co.uk) Received: from crf-consulting.co.uk (82-44-220-218.cable.ubr10.haye.blueyonder.co.uk [82.44.220.218]) by jc.ngo.org.uk (8.12.11/8.13.1) with ESMTP id iB6JKJfZ027312; Mon, 6 Dec 2004 11:20:21 -0800 (PST) (envelope-from nik@crf-consulting.co.uk) Received: from clan.nothing-going-on.org (clan.nothing-going-on.org [192.168.1.20]) by crf-consulting.co.uk (8.13.1/8.12.9) with ESMTP id iB6JKJCJ089203; Mon, 6 Dec 2004 19:20:19 GMT (envelope-from nik@catkin) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) iB6JKJuO074212; Mon, 6 Dec 2004 19:20:19 GMT (envelope-from nik@clan.nothing-going-on.org) Received: (from nik@localhost) by clan.nothing-going-on.org (8.13.1/8.13.1/Submit) id iB6JKILB074211; Mon, 6 Dec 2004 19:20:18 GMT (envelope-from nik) Date: Mon, 6 Dec 2004 19:20:18 +0000 From: Nik Clayton To: Eric Anderson Message-ID: <20041206192017.GE72462@clan.nothing-going-on.org> References: <20041205114254.GD23252@clan.nothing-going-on.org> <41B3617B.3080507@centtech.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="Ycz6tD7Th1CMF4v7" Content-Disposition: inline In-Reply-To: <41B3617B.3080507@centtech.com> User-Agent: Mutt/1.4.2.1i Organization: FreeBSD Project cc: doc@freebsd.org cc: Nik Clayton Subject: Re: Time for a Network Handbook? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 06 Dec 2004 19:21:11 -0000 --Ycz6tD7Th1CMF4v7 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, Dec 05, 2004 at 01:28:59PM -0600, Eric Anderson wrote: > Nik Clayton wrote: > >Anybody got any strong feelings about moving the existing "Network > >Communication" out of the Handbook, and using it to seed a new > >FreeBSD Networking Handbook? >=20 > What's the reasoning behind it? I like it in the Handbook personally -= =20 > it fits with the rest of the book. Partly to move closer (as others have said) to having a collection of Handbooks. But mainly because I was glancing over the existing content and it struck me as odd that mail gets its own chapter while most of the other network services have to sit in together. So the natural thing to do is to give each network service its own chapter. Which would increase the size of the Handbook somewhat. So slicing them out in to a separate networking handbook could be appropriate. I also think that giving each service a 'standard' structure: Synopsis Terminology Client Server will lend some needed uniformity to the content, and make it easier for someone to start documenting additional services (IMAP? POP3? DAV? ...). While I think about it I'm beginning to think that Terminology ("Glossary"?) might make sense as a 'standard' in all the other chapters too, in the same way that Synopsis is. N --=20 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 --- .\._/= _) --Ycz6tD7Th1CMF4v7 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (FreeBSD) iD8DBQFBtLDwk6gHZCw343URAgwiAJ93iGg+GfhkSEW2vx0mz7+2RjSe+gCgjeCB Kppgswugxxx57FzLNwZGh50= =rdKY -----END PGP SIGNATURE----- --Ycz6tD7Th1CMF4v7--