Date: Mon, 12 Jul 2004 17:31:25 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: doc@freebsd.org Subject: Handbook Acronyms Message-ID: <20040712171533.R43767@wonkity.com>
next in thread | raw e-mail | index | archive | help
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...
In the HTML version, the entire "NFS (Network File System)" would be a
link to the glossary. Later references and links would just be "NFS".
If every acronym is defined in the glossary, is it possible to generate
the link and definition the first time an acronym is used in a chapter?
-Warren Block * Rapid City, South Dakota USA
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040712171533.R43767>