TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:A very detailed glossary From:Jon Herrera <jonherrera -at- YAHOO -dot- COM> Date:Tue, 13 Oct 1998 16:31:32 -0700
Hi Technical Communicators!
I started out writing a glossary for one of our manuals. The glossary
consisted of about twenty-five terms and their definitions. As the
review process went on, I?ve been asked to add a more detailed
explanation of how each is used and an example for each term. I?ve
now ended up with about one to one-and-a-half pages of text for each
term. Is this still a glossary?
I?m now inclined to call this something other than a glossary. Has
anybody created something like this, a very detailed glossary?
I?m also looking for formatting suggestions. Should I have
subheadings for definition, usage, and examples for each term?
Please send replies to me directly because I receive list messages in
the digest format.
Thanks,
Jon Herrera
jonherrera -at- yahoo -dot- com
_________________________________________________________
DO YOU YAHOO!?
Get your free @yahoo.com address at http://mail.yahoo.com