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: What audience should I target? From:"Kathleen" <keamac -at- cox -dot- net> To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Fri, 6 May 2005 07:46:12 -0700
Yevgen,
In the worst case scenario, when Gale and Michael's suggestions won't
work, you can try another tack:
Try to get a feel for the "expected" user's sophistication and knowledge
by the types of things you're explaining. Then, write a short draft
aimed at the lowest common denominator and give it to the customer for
review and approval. (If you can't get a good feel, just do a draft
aimed at the least knowledge.) Explain to the customer that you need a
sense of what is appropriate, and they are the final judge (and "should"
have the necessary information). The most important thing is to be sure
that the instructions are complete, even for experienced/knowledgeable
users.
Without good information about the user, it's always safest to aim at
the basic level for the sake of usability. To address a wide range of
user skills, an introductory overview can suggest that experienced users
might want to review the highlights of a section (or use the review for
a reference), or point them to the next section they need. You can
always place more basic/complete instructions in a subsection or chapter
and point to it from other sections/chapters.
Good luck
Kathleen
-----Original Message-----
From: Gale Stafford
Your customer must employ hundreds of people who are familiar with the
technical skills of the intended audience. If I were you, I'd just ask
for a
one hour of time to interview a manager or some other SME in the
customer
support department.
-----Original Message-----
From: Borodkin, Yevgen
Sent: Friday, May 06, 2005 8:03 AM
To: TECHWR-L
Subject: What audience should I target?
Hello everyone!
I am relatively new to the list, sorry if I am raising an old issue.
My customer (a big international company) doesn't tell me anything about
the
intended audience of the hardware and software user documentation I am
writing. All I get is a specification and a few other supplementary
documents (data sheets and the like). It's not always easy to figure out
just how technically savvy the users are or may be. Any ideas how to
deal
with it?
WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo: http://www.webworks.com/techwr-l
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit http://www.techwr-l.com/techwhirl/ for more resources and info.