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.
Re: "How to Help Anyone Understand How to Do Anything"
Subject:Re: "How to Help Anyone Understand How to Do Anything" From:Lin Sims <ljsims -dot- ml -at- gmail -dot- com> To:"TechWhirl (techwr-l -at- lists -dot- techwr-l -dot- com)" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Mon, 30 Apr 2018 10:08:38 -0400
I'd have to say no, it doesn't.
Like so many other questions in the technical writing world, I suspect the
answer here is, "it depends". For instance, I have to disagree when the
"Yes, our audience is smart, but we must pretend that they've just been
beamed onto the planet and have never seen a knitting needle, or an Allen
wrench, or an IRS agent who can explain exactly what adjusted gross income
"Know thy audience" is a dictum for a reason. If you're writing for another
IRS agent, for example, or for a CPA, then explaining what an adjusted
gross income is or how to calculate it isn't necessary, or at least not to
the extent that most of us poor taxpayer require. Your audience is not
always, or even not often, ignorant.
Further, while the list of 6 components is certainly useful, which of them
are appropriate or even needed again depends on your audience and also your
On Mon, Apr 30, 2018 at 9:29 AM, Cardimon, Craig <ccardimon -at- m-s-g -dot- com>
> Greetings Whirlers,
> I came across this article today and wondered what you all might think of
> it. The subhead reads: "Instructions made easy." Has the author succeeded
> in making instructions easy?
> Craig Cardimon
> Senior Technical Writer
> Information contained in this e-mail transmission is privileged and
> confidential. If you are not the intended recipient of this email, do not
> read, distribute or reproduce this transmission (including any
> attachments). If you have received this e-mail in error, please immediately
> notify the sender by telephone or email reply.
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | http://techwhirl.com
> You are currently subscribed to TECHWR-L as ljsims -dot- ml -at- gmail -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
> 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
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com