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