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: "always read and follow the instructions" From:Peter Neilson <neilson -at- windstream -dot- net> To:Gene Kim-Eng <techwr -at- genek -dot- com> Date:Tue, 03 Jun 2008 12:41:59 -0400
Additionally, if a court of law is judging whether Hapless J. User
received sufficient warning of the harmful nature of the product, then
redundancy will stand well on the side of the defense. Law is full of
superfluous words: "I hereby give, bequeath and devise..." I have been
told that they are there for good reason.
At one place where I worked we invented (but never implemented) some
RTFM software. When you start the software it asks, "Have you read the
manual?" The correct answer, buried in the manual, is, "You betcha!" or
something like that. A simple, "Yes," won't do and will not allow you to
proceed.
Gene Kim-Eng wrote:
> In situations where your products can kill their users
> if not operated correctly it is often SOP to say "read
> and follow" because you want the users to read the
> procedures in their entirety before attempting to
> perform them rather than just following them blind
> (because it's entirely possible to follow a set of steps
> without having first learned them)..
>
> Gene Kim-Eng
>
>
> ----- Original Message -----
> From: "Milan Davidovic" <milan -dot- lists -at- gmail -dot- com>
>> When I see a statement in a manual such as "Always read and follow the
>> instructions in this manual", two thoughts come to mind:
>>
>> - Following the instructions in the manual (i.e. the ones actually in
>> the manual, not the instructions you imagine) presupposes having
>> learned them, so the direction to "read" them is redundant.
>> - Telling someone to "do x" with no qualifiers provides no options,
>> so the modifier "always" is redundant.
>>
>> Do you think "always read and follow the instructions" is likely to be
>> more effective than "follow the instructions"? Do you think it depends
>> on the context?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-