Date: Wed, 14 Jul 2004 13:07:59 +0000 From: Murray Stokely <murray@FreeBSD.org> To: Warren Block <wblock@wonkity.com> Cc: doc@freebsd.org Subject: Re: Handbook Acronyms Message-ID: <20040714130759.GD66732@hub.freebsd.org> In-Reply-To: <20040712171533.R43767@wonkity.com> References: <20040712171533.R43767@wonkity.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, Jul 12, 2004 at 05:31:25PM -0600, Warren Block wrote: > In most books, the first use of an acronym or term is defined. With the > Handbook, that is probably not very helpful, since most users will not > read it straight through and may miss the definition. > > A glossary would help, particularly for HTML, where the definition is > just a link away. This fails on paper versions of the Handbook, though. > > Ideally, the first use of a glossary term in a chapter would have a > short definition: > > With NFS (Network File System), files may be... This reads better as 'With the Network File System (NFS), files may be...' rather than having the expanded form in parenthesis, but otherwise I agree with your main point of avoiding undefined acronym-overload. - Murray
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040714130759.GD66732>