Date: Mon, 6 Dec 2004 19:20:18 +0000 From: Nik Clayton <nik@freebsd.org> To: Eric Anderson <anderson@centtech.com> Cc: Nik Clayton <nik@freebsd.org> Subject: Re: Time for a Network Handbook? Message-ID: <20041206192017.GE72462@clan.nothing-going-on.org> In-Reply-To: <41B3617B.3080507@centtech.com> References: <20041205114254.GD23252@clan.nothing-going-on.org> <41B3617B.3080507@centtech.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--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" <part> 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' <sect1> 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20041206192017.GE72462>