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: Fun fact From:Janet Valade <janetv -at- MAIL -dot- SYSTECH -dot- COM> Date:Mon, 22 Jun 1998 16:28:22 -0700
> I don't get blank stares, I get "so those $%* books are YOUR FAULT! No,
> I'm
> sure yours are clear and easy to read, not like the ones that come with
> VCRs
> (you don't do VCR manuals, do you?) ..."
>
I have to mention that I just bought a new VCR. The registration card I
filled out included a question: Was the manual: easy to use, neither easy or
hard, or hard to use? It was nice to know that someone cares. However, I
had to answer hard to use.
The problem was one I think we have discussed before. The lead-in to the
procedures were task oriented, but not tasks that had any meaning to me. For
example, a section that starts:
To re-load the channels into memory: (followed by steps)
I spent a long time trying to figure out if I wanted to reload channels into
memory. I reread the entire manual and found no explanation of why I had
come to this step. Why might I want to reload channels into memory? Why
reload? How did they get unloaded? Etc.
I was so annoyed. With lines between the sections, I didn't know if I was
supposed to do all the sections in order, regardless. Or only do those that
needed doing. Which were those? RRRRrrrrr.
Janet
----
Janet Valade,
Technical Writer, Systech Corporation, San Diego, CA mailto:janetv -at- systech -dot- com
----------------------------------------------------------------------------
--------------------------------------------------
For every complex situation, there is a solution that is simple, neat, and
wrong.