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:Context Sensitive Help From:Becca Price <RP51 -at- CHRYSLER -dot- COM> Date:Thu, 8 May 1997 11:11:02 EDT
On the winhlp-l, there has been much discussion on context sensitive help
lately. Too often, it seems, when people talk about it, they are talking
about how to implement it, not what the contents should be.
We're currently debating this in my department, so I thought I'd get other
comments.
As users, what do you like to see when you ask for context-sensitive help?
do you want field-level information, as in Win95-style What's This? help?
or do you want to see what someone else thinks might be the most appropriate
topic? or possibly a list of options that could include field definitions
and information about common procedures? Should cs-help be at the field
level or at the screen level?
If field level help is the most appropriate, should the cs-help command (F1,
shift-F1, whatever) be the *only* way to get at this information, or should
there be links to that topic in the general help file, as well?
Right now, I'm not talking any specific platform - your answers can relate
to Windows, DOS, Mac, UNIX, whatever. The question is, what kind of
context-sensitive help is most useful to the users?
The specific type of application we're documenting is a database application,
for data entry, retrieval, and analysis... but don't necessarily limit
your answers to that.
This has become a matter of interest to me, primarily because I haven't found
much written about it anywhere.
TIA,
Becca
rp51 -at- chrysler -dot- com
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html