RE: RTFM? Really?

Subject: RE: RTFM? Really?
From: <Brian -dot- Henderson -at- mitchell1 -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 26 Sep 2014 18:17:41 +0000

I too will admit that I'm not a manual-reader.

I have been long-trained to assume that a (consumer product) manual will likely be:
1. Poorly written.
2. Frustrating.
3. Confusing.
4. Will cause my blood pressure to rise to dangerous levels.
My general attitude is that I'll look at the instructions if I run into trouble.

And, I will rarely call Product Support because I also assume a high likelihood they too will not be helpful.
(especially if the documentation is really bad)
So there's that bright spot for companies worried about phone support costs.

I have come to the conclusion that the root of the problem is the inability of designers and writers to approach their products from an "ignorant" perspective; to be able to see things from the point-of-view of someone who has no idea how the product is assembled and/or operates. It's not that I believe the responsible parties don't try - it's that they are truly unable to "forget" what they know about the subject. So much of what seems "obvious" to producers is anything-but to most everyone else. And even though writers can be just as guilty of this, I consider them to be only point in the process where the trait has a possibility of being offset. Writers are often a member of the "great unwashed" and are seeing a product for the first time when they're asked to document it. Trying to make sense of something for themselves can be the key to creating instructions that make sense to others.

I'm probably just venting here. I don't actually believe that I'm telling y'all anything you don't already know. I think that (overwhelmingly) the members of this discussion-list are not the sort of writer that has led to my low opinion of so much what passes for "instruction".

And don't even get me started on products designed completely inside a computer, and sent straight to production without prototyping. Some of the worst products I've run across have clearly gone to market that way.

Brian H.

-----Original Message----- From: Karl Norman

I've noticed that when members of this listserv start talking about
manuals, the level of strong language rises significantly (e.g. rtFm!).
This seems odd to me because I don't want to read a manual either. I learn
better through human contact. I understand that it costs a lot when a user
makes a support call. But, good grief, I bought a thing from you; the least
you could do is help me use it. And if your response at my most vulnerable
hour is "rtfm," or even "I'll help you for a price," then you've just lost
my loyalty as a customer. I have no respect for a company that only gets
out of bed for POS.

My thought is, if your users don't read your manuals, then why do you keep
writing manuals? Has anyone been with a company that stopped writing
manuals altogether? What about using more video tutorials? Or even setting
your users to work for you by helping each other through forums? I'd really
like to hear from both sides: the writers who insist on manuals (why?) and
the writers who have sought out alternatives (why?).

--


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
RTFM? Really?: From: Karl Norman

Previous by Author: RE: Writing vs. Editing
Next by Author: RE: Questions about the work day for the Whirlers
Previous by Thread: Re: RTFM? Really?
Next by Thread: Re: RTFM? Really?


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads