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: Friday Poll Idea (WAS: In love with a word) From:"Nuckols, Kenneth M" <Kenneth -dot- Nuckols -at- mybrighthouse -dot- com> To:<techwr-l -at- lists -dot- techwr-l -dot- com> Date:Mon, 9 Jan 2006 09:46:36 -0500
Mark Levinson said...
>
> > sometimes it just seems like the task requires some
> > kind of reassurance.
>
> I think it's risky to tell users that what they're
> about to attempt is "straightforward," or worse yet
> "simple" or "easy". By doing so, you're telling them
> that in the best case, when they've quickly mastered
> the procedure, they don't deserve any credit, and in
> the worst case, when they encounter difficulty understanding
> or performing the procedure, you consider that they must
> be numbskulls.
>
> As in much marketing writing, the ideal is to put the
> favorable idea into the reader's head without explicitly
> stating it. If you can say something like, for example,
> "the whole procedure can be thought of as four steps," then
> you can hope the reader can say, "Why, that looks easy!"
> and because it's the reader's own opinion, it won't meet
> the resistance that an explicit claim of easiness would
> need to penetrate.
>
I have tried to avoid using that sort of preamble for two reasons: the
first is just like Mark said--if I tell them the procedure is simple and
they find it difficult, it implies that I'm calling that individual
reader/user stupid. The reality is that I probably haven't done a good
job conveying the simplicity by writing a proper procedure.
The second reason I try to avoid such introductions is that they just
seem like "fluff" or "padding" to me. I consider that people read what I
write not because it's some great literary masterwork but because they
have a task to finish and they want to be done. So why should I delay
them with any extra rhetorical drivel, no matter how well-intentioned?
CONFIDENTIALITY NOTICE: This e-mail may contain information that is privileged, confidential or otherwise protected from disclosure. If you are not the intended recipient of this e-mail, please notify the sender immediately by return e-mail, purge it and do not disseminate or copy it.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author
content and configure Help in MS Word or any HTML editor. No
proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-