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: Scenario: You're hired a new writer... From:Betsy Perry <betsyp -at- VNET -dot- NET> Date:Fri, 30 Jan 1998 10:27:12 -0500
Anonymous asks:
------- start of forwarded message -------
Here's the scenario:
You've hired a new writer (with 1-2 years experience). You've given
them no information on what is expected of them, but you have given them
a variety of assignments. What do you expect them to be able to do with
the following assignments:
Convert to documents to on-line.
Index a new manual.
Input edits marked-up by your technical editor.
Write a documentation plan.
Write a manual.
Write a white paper.
Update a manual.
------- end of forwarded message -------
(I'm using "young" to mean "inexperienced" here; somebody can be a
"young" technical writer at 67 if he's only got a year of writing
experience.)
What I expect writers to know depends on what they told me in the
interview. If the writer told me that she'd indexed manuals, I'd
expect her to be able to create an index without close supervision; if
she didn't mention it, I wouldn't make any assumptions. I would
expect a young writer to be very familiar with updating manuals,
because most pubs departments reserve creating documents from scratch
for the more experienced writers. If a writer didn't know how to
write a documentation plan, I'd take an hour to teach him.
I expect young writers to be unfamiliar with many tasks. What matters
is how they _confront_ unfamiliar tasks. Does the writer say "Gosh,
I've never done an index before, how can I learn?" Or "I haven't
converted to HTML before; should I just read the manual and plunge in,
or are there special rules you want me to follow"? Or does he say "I
don't know how to do that. I guess I'd better do something else", or,
worse yet, "I haven't had a class in that, so I can't do it."? Worst
of all is the writer who can't do a task, but never tells her
management she has a problem.
I expect writers to be willing to train themselves; writers who can't
be bothered to learn unless somebody is teaching them are a dead
weight in any department. An inexperienced writer who learns well and
quickly won't stay inexperienced long. A writer who won't learn
soon becomes "inexperienced" because his/her experience is out of date.
--
Elizabeth Hanes Perry betsyp -at- vnet -dot- net