Split of Advanced Networking chapter of Handbook

Murray Stokely murray at FreeBSD.org
Tue Jul 13 02:35:22 UTC 2004


On Mon, Jul 12, 2004 at 05:53:38PM +0100, Tom Hukins wrote:
> 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:

Yea I agree all the section names should be like your list.  Some of
them are already I think.  

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

Agreed.

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

Index terms are something separate.  Many terms are already there in
both expanded and acronym form (possibly with a <see> marker).  The
index terms may still need cleaning up, but that isn't a replacement
for expanding section titles.  There is space pressure to keep the
index entries concise and so acronyms aren't as frowned upon in an
index, I think.  Four words like 'Network File System Server' is
pushing the space limitation for two column index output in a book --
especially if you then have secondary index terms beneath it.

> these lines.

Please don't make this kind of commit until I do the split so that my
patch will still apply cleanly.

      - Murray



More information about the freebsd-doc mailing list