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.
As Jonathan aptly observes:
"I feel the real reason we have instructions and warning notes is for the
lawyers . . ."
Exactly. Even though readers tend NOT to read these items, we cannot afford
to leave them out of the documentation and my response was not intended to
suggest that I advocated that. Far from it.
If we want the tips, notes and warnings to be of value, we need to find a
more meaningful way to deliver them that protects the manufacturer from a
lawsuit and still provides critical information necessary to safeguard the
humans working on the machinery.
Thanks to Jonathan for bringing this point to everyone's attention.
Regards,
Pete Sanborn
-----Original Message-----
From: bounce-techwr-l-81537 -at- lists -dot- raycomm -dot- com
[mailto:bounce-techwr-l-81537 -at- lists -dot- raycomm -dot- com]On Behalf Of Jonathan
Soukup
Sent: Wednesday, November 21, 2001 1:23 PM
To: TECHWR-L
Subject: RE: Notes, tips, and warnings... oh my!
>>>As Pete says, readers don't read notes. But it has been observed that
readers don't read steps either.
To be honest, I feel the real reason we have instructions and warning notes
is for the lawyers, not necessarily the users. Ok, so I'm pessimistic, but
go ask your boss what's more important: Will the user understand the
instructions? OR Will the user file a class action law suit against us
because of these instructions?
-Jonathan Soukup
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of
your book. What are you waiting for? http://www.iuniverse.com/media/techwr
---
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.