Date: Tue, 13 Jul 2004 02:35:22 +0000 From: Murray Stokely <murray@FreeBSD.org> To: Tom Hukins <tom@FreeBSD.org>, doc@freebsd.org, doceng@freebsd.org Subject: Re: Split of Advanced Networking chapter of Handbook Message-ID: <20040713023522.GB85720@hub.freebsd.org> In-Reply-To: <20040712165338.GA16218@eborcom.com> References: <20040712100256.GB3948@hub.freebsd.org> <20040712165338.GA16218@eborcom.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040713023522.GB85720>