Date: Mon, 06 Dec 2004 20:26:27 +0100 From: Remko Lodder <remko@FreeBSD.org> To: Nik Clayton <nik@freebsd.org> Cc: doc@freebsd.org Subject: Re: Time for a Network Handbook? Message-ID: <41B4B263.7060804@FreeBSD.org> In-Reply-To: <20041206192017.GE72462@clan.nothing-going-on.org> References: <20041205114254.GD23252@clan.nothing-going-on.org> <41B3617B.3080507@centtech.com> <20041206192017.GE72462@clan.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Nik Clayton wrote:
> 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?
>>
>>What's the reasoning behind it? I like it in the Handbook personally -
>>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
I like the entire idea :-) The Dutch team will proudly follow
translating the stuff when it's available :-)
--
Kind regards,
Remko Lodder
FreeBSD (Dutch) Documentation Team
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?41B4B263.7060804>