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: Data on who uses Help? From:aschiff -at- factset -dot- com To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Mon, 25 Mar 2002 14:05:30 -0500
First off, I'm going to concur with Geoff Hart on this one -- it doesn't
really matter who *generally* uses help; you're only interested in the
users of your software, correct? Are those users are 22-year-old Web
developers, or 95-year-old Web-surfin' Grandmas? Know your audience.
As for "advanced" help - I really believe that this is an underdeveloped
area in online help. Another techwrl-er opined that new users need
step-by-step instructions. Well, I'd agree, but I'd go so far as to say
that advanced users often need the same thing.
The difference is that there's a fairly finite set of possible tasks that a
basic user might want to accomplish, whereas advanced users may be pushing
the limits of your software and you have no idea what the heck they might
be doing -- hence, it's more difficult to provide help for them. Think of
concentric circles -- the smallest one, in the center, represents basic
users. Each ensuing circle is larger. It's a lot harder to capture
everything in, say, the 5th circle out, than it is to document the
innermost circle. And unless you live in Bizzarro-World, you have deadlines
to meet and can't spend months doing needs analysis & figuring out which
advanced tasks to document.
Speaking from my own experience as a fairly advanced end-user in Macromedia
Flash, I really like what they've done:
* Their online help is fairly basic for the task-based material, but also
includes more advanced reference material (i.e., a glossary of all
* Their website contains a knowledgebase that runs the gamut -- from basic
troubleshooting, to advanced tips & tricks, to intermediate & advanced
"scenarios" with step-by-step annotations and downloadable files to go with
I can't speak for Macromedia, but I'm guessing that by deploying the
intermediate/advanced scenario-based material via their Website, they can
update it more frequently and not be constrained by release dates when
developing that material. (Perhaps they cull ideas from their online
community discussions or their help-desk, then release it bit by bit.)
PC Magazine gives RoboHelp Office 2002 five stars - a perfect score!
"The ultimate developer's tool for designing help systems. A product
no professional help designer should be without." Check out RoboHelp at http://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.