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.
>>>I have been taught (and believe) that Windows Help should not take the
place of
a user's manual and should not become simply an electronic version of the
user's manual. Help is (or should be) that information a user needs
immediately
to solve a problem. Help is driven by topics (info chunks) and, since the
WinHelp environment is interactive, the user can navigate to the depth of
knowledge that is necessary to complete that task. Help is not a lineal
environment, as a user's manual is, even an electronic user's manual.
Our philosophy is that most users who are stumped in an app will go directly
to
the Search button and look for information about the concept that they need,
before they go to a Contents section or even a How To... section.<<<
My experience also is that people who use Help tend to go to the Search
button first. This means that your search keys need to be the equivalent of
a good index. But it does not necessarily mean that the content of Help
needs to differ from the content of a paper manual, though the chunking is
different. I find that (setting aside the folks who won't look anything up
on their own so long as they can find someone to ask) some people use paper
sources, and some people use on-line sources, and each group turns to the
other source only reluctantly. So I try to keep both sources containing
pretty much the same information, organized appropriately for the medium,
and well indexed.
K Watkins
kwatkins -at- quickpen -dot- com
speaking for myself, not my employers