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.
Re: USA Today article demands printed documentation
Subject:Re: USA Today article demands printed documentation From:Chris Hamilton <caxdj -at- EARTHLINK -dot- NET> Date:Tue, 16 Feb 1999 15:56:04 -0500
John--
The article was a single anecdotal account. I'm not going to make my
decisions based on that article. It's not that the author's opinion (or
Garret's, for that matter) is invalid. It's that it's an opinion. Before
I take a decision, I want some kind of more universal feedback from my
audience.
As I said in the "Aunt Martha" scenario, in some cases, comprehensive
printed documentation is the right thing to do. My point was that
sometimes it's not. The article didn't account for that possibility.
As for the lowest common denominator, that's one of the reasons we get
paid the big buck, to figure that out. I try to aim for someplace just
less than the middle. For instance, in an object-oriented programming
tool, I'm not going to explain what objects are. I will state an
assumption that says I expect readers to know this information. There
are plenty of resources for finding this information outside of what I
write.
I'm sorry if that sounds callous, but sometimes you have to do what you
can instead of what you should, deadlines and contraints being what they
are.
If I came across as being snotty about the whole thing, that wasn't my
intent.
Chris
--
Chris Hamilton
Technical Writer
Tampa, FL
caxdj -at- earthlink -dot- net