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.
"John Posada" wrote...
>
> However, since Check Point Software Technologies is in the internet security
> biz (I even checked out your web site), of what value is it to the company
> (and documentation department) to claim documentation awards?
I can speak uniquely to that. I wrote security documentation that won awards.
The largest problem with most technical writing contests, particularly the STC
ones, is that they are based almost exclusively on layout and look and feel.
There is no analysis (or minimal) analysis of the content. This makes any win
in those contests almost meaningless.
I would reccommend that Anna use reviews of their products as a yardstick for
documentation quality. Normally, if documentation is mentioned at all in a
review, it is either praised (rare) or slammed. If a technical auditing team
praises the documentation, that means it did an excellent job of explaining the
technology. That is the best contest you can win. Its an honest, real-world
evaluation of the docs by folks that are really using the products.
My suggestion is similar to John's...get some trade magazines like Information
Security or eWeek to review your products. Specifically ask them to review the
documentation, if possible. Then pay close attention to the areas of the
products they mention as confusing or poorly designed. This is an area you
might want to improve in the docs.
Andrew Plato
__________________________________________________
Do you Yahoo!?
Yahoo! Tax Center - File online, calculators, forms, and more http://platinum.yahoo.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Purchase RoboHelp X3 in April and receive a $100 mail-in
rebate, plus FREE RoboScreenCapture and WebHelp Merge Module.
Order here: http://www.ehelp.com/techwr-l
Help celebrate TECHWR-L's 10th Anniversary starting this month!
Check out the contests at http://www.raycomm.com/techwhirl/special/contests/
Happy birthday to you, happy birthday to you, happy birthday TECHWR-L....
---
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.
