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 want to thank you all for taking the time to give me some good thought
provoking answers. You've reminded me of some ideas I'd forgotten, and
supported some of my original reactions to the issues at hand.
I especially appreciated Geoff reminding me to think about
context/sensitive or embedded Help. The client has indeed begun to do
this, but there is room for improvement. So I will encourage them to
proceed, but make some suggestions.
Organization is indeed going to be the key here. As I learn about the
business processes and how they are handled via the SW, I will be sure
to pay attention to this.
My client believes strongly that their end-users need to have access to
information about what the SW is doing in the background. From what they
have said, I believe it's because of the sensitive nature of some of the
tasks. Clients want to be reassured that a process is handled in a
certain manner. Yes I agree with Geoff and others... I really don't
think the client wants to know what the SW is doing in the background.
What they really want to know is how to do something, and how they know
it is accomplished. I think I can provide the information the client
wants in a way that is more focussed on how the user's needs are met.
Finally, I believe that Doris's idea of a customizable Help landing page
is brilliant. If anyone has some suggestions or tips for how that could
be integrated with FlashHelp, please let me know. Doris shared a few
thoughts on this as well. I will see how the client reacts to this idea.
Of course, at the end of the day, it will all break down into funding,
and what is feasible at this time or not. I do know that my client has
already added some of my ideas to their list of future improvements. So
I am optimistic in the long run.
Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices. http://www.doctohelp.com/SuperPages/Webcasts/
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-