Handbook Acronyms

Murray Stokely murray at FreeBSD.org
Wed Jul 14 13:08:00 UTC 2004


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



More information about the freebsd-doc mailing list