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 agree with John and Bonnie. The customer already bought your product,
so you don't need to dazzle them with marketing hype. However,
technical publications, just as any form of customer service, are a form
of marketing. If the manual is professional, easy to follow and helps
the customer quickly get up to speed, then chances are they will either
buy more of your products, or give you good word-of-mouth advertising to
acquaintances that could also use your product. With that said, you
need to get clarification from your boss about what he means "making the
manuals more purposeful and focused." Getting a lot of examples will
give you a lot of ideas, but they may not conform to your boss's
ideas. You can, as Bonnie suggests, have an expert critique it, but I
would begin meeting with your boss, then you'll have a better
understanding of what you want the expert to look at.
Al
John Posada wrote:
Understand what the product is going to do to make their job easier
or more productive, then tell them in an easy-to-read form. This is
not the place to WOW them technically...it is the place to do so emotionally.
Granat Wrote:
Peggy, I think the way to go is to have a person who is an expert at
critiquing technical books evaluate your existing manual and offer concrete
suggestions about how to improve it.
--
Al Geist, Geist Associates
Technical Writing, Online Help, Marketing Collateral, Web Design, Award
Winning Videos, Professional Photography
Office: 802-658-3140
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
Doc-To-Help 2005 converts RoboHelp files with one click. Author with Word or any HTML editor. Visit our site to see a conversion demo movie and learn more. http://www.componentone.com/TECHWRL/DocToHelp2005
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.