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.
Please forward to techwr-l on my behalf, as I can't post directly. I
think you've started an interesting thread, and I'd like to
contribute. Thanks!
--Geoff
*************
Stuart Burnfield raised the very important distinction between
the stereotypical audience ("grateful but passive recipients") and
users (who actually perform tasks), and I hope we get to discuss this
a bit. It's important to understand that audiences are rather complex
beasts. For example, our typical "clients" (as I gracefully avoid the
"a" word!) might include the following:
- people of varying levels of expertise who have tasks to perform
using our documentation ("users").
- people who need to understand the overall nature of our software
(its potential and its limitations) to facilitate their planning,
even though they won't ever do the actual tasks ("managers")
- people who want to learn about a subject to expand their knowledge,
without ever having to do the tasks ("learners" or "browsers")
- people who must support others in their use of the product ("tech.
support", MIS, etc.)
- people who want to use our docs as the basis for writing "X for
Dummies" books <g>.
- people who want to use our docs as part of the overall product
package ("marketers", "checklist-based purchasers")
No wonder audience analysis is a frightening thought! I suspect that
the majority of a technical communicator's audience is concerned
primarily with performing tasks based on the documentation, but
there's still a sizable minority that has other goals.
--Geoff Hart @8^{)}
geoff-h -at- mtl -dot- feric -dot- ca
Hart's corollary to Murphy's law: "Occasionally, things really do work right."