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>