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: STC Letter to the Editor From:"CB Casper" <knowone -at- surfy -dot- net> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Mon, 04 Nov 2002 10:55:01 -0800
If the STC had a contest to write documentation
about ONE product (say an open source product
poorly documented) and then judge the entries,
THAT would do a whole bunch of good to everyone.
The open source product would get documented,
evaluated, examined, and thoroughly wrung out
by the various TW's.
Differences between documentation approaches
for the same product could be compared on truly
technical aspects. For docs with similar level
of technical merit, presentation could be judged
as a separate award.
The judges would have to learn the product, but
once they have, it would be easier to evaluate
subsequent entries, and they learn something new.
Publication of winning and losing entries
would serve to educate everyone interested in
different approaches to docs to enhance the skills
of technical communicators.
This would be an award worthy of winning.
> The whole idea of technical communications
> is to communicate complex ideas clearly.
Surfy! http://www.surfy.net Great web search, free web email, and $9.95 unlimited Internet access
Powered by Outblaze
Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!
All-new RoboHelp X3 is now shipping! Get single sourcing, print-quality
documentation, conditional text and much more, in the most monumental
release ever. Save $100! Order online at http://www.ehelp.com/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.