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:Re: Glossary functions and features in elearning From:Dick Margulis <margulis -at- fiam -dot- net> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Mon, 28 Jan 2002 17:45:39 -0500
Brad,
I would strongly recommend that you leave all glossed words undecorated
and uncolored. In other words, they should look just like the
surrounding text. I say this because, from your description, passages
would start to be heavily populated with links; and once a reader knows
the word, visible links are merely distractions. They do not aid
comprehension.
Okay, so if you can't determine which words are glossed by looking at
them, what do you do? Some thoughts:
The author (not the software) can decide to bold words to cue the reader
about the glossary entry. Typically an author would do this on the first
occurrence (or perhaps the first occurrence in each unit, if the units
can be accessed independently).
Readers should be instructed, once, that to learn about any unfamiliar
term in the text, they should float the mouse over the word (or,
perhaps, click the word).
On mouseover, you could show a tooltip (or Title/Alt text, whatever you
want to call it, but you know what I mean). This might be either the
definition itself (if it is short enough), or an instruction to click
the word for a full definition.
I think doing it this way would keep it unobtrusive but easily available.
My two cents.
Dick
Brad Jensen wrote:
Some questions I have for you all are:
1. Are there any favorite/semistandard colors for such links?
2. what would you do if such a word (dogwood) is inside an html
link (innertext)
3. what do you love and hate about the glossary definers you
have in other products now?
A
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Attention ForeHelp and Doc-to-Help Users! Upgrade your existing product to
RoboHelp for only $299, through January 31st. RoboHelp can import your
existing Help projects! Learn how else RoboHelp can benefit you. www.ehelp.com/techwr
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.