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.
well, I guess the first question might be: what kind of online help do you
need in the programs you use?
Would your needs then apply to the program's users?
now, on with the theoretical blathering <g>....
I'd imagine there'd be 3 major types of information that could go into
online help: conceptual stuff (what is a widget?), tasks and procedures (how
to add a widget), and dialog or field-level information (what am I supposed
to put in this field, and what are all these buttons for?).
Imho, dialog/field level help should do more than simply reiterate the
options for the field; it should tell me the ramifications of my choices.
And also, imho, online should be more weighted with immediate use
information, than with high-level conceptual information.
But I'm probably a bit biased, since my first online project was for an
in-house sales force automation tool used by our sales reps while on the
road and at customer sites. They couldn't lug around a giant manual, but
needed instructions pretty immediately.
-----Original Message-----
>I am being asked to get some online help started. The advice I need is
>this: I do not want to regurgitate my hardcopy user manuals into online
>help.
>However, I have no idea how to approach online help, figuring out what
>should go into it, how online help is different than user guides, etc.
>I need to know the theory and design, not the tools.
>Any and all constructive advice is appreciated. Thanks in advance!