Definition of Tech Writer, was STC is broken
Ned Bedinger
doc at edwordsmith.com
Mon May 5 18:47:57 MDT 2008
Sam Beard wrote:
> Lauren,
>
> To say that technical writing doesn't require research is just
> patently wrong. First off, there's the research in learning about new
> technologies and new ideas. Then, there's the research that comes
> part-and-parcel with certain types of technical writing or technical
> writing jobs.
For the sake of defining the terms we're using in these debates, I'll
take on this one: doing research is what "digging out and organizing all
information resources" can be called.
example: When I'm researching, I don't feel like I can stop looking when
I've picked the low hanging fruit in the team's documentation share.
Research has to be thorough. I'm not sure there is such a thing as doing
some research. If you've done the research, you've been thorough, to
your standards. If research is like gathering fruit, then when I am
researching I will shake the tree. I will shake the tree hard,
disruptively so, and then get a long stick and whack around blindly up
in the leaves and high branches.
I think the fruit tree metaphor for information storage witnesses the
fact that we have arboreal ancestors, and that what we call research can
be traced back to arboreal survival skills.
The workplace, on the other hand, pretends to be organized in a more
civilized metaphor, with file drawers instead of fruit trees. How easily
I could do thorough research, if the file drawers held it all.
Unfortunately, having roots in the trees means not really filing very
well. A lot of information that belongs in the file drawers remains up
in the branches with its "owners." Tracking that info down and
successfully getting it is what a tech writer's research means to me.
> writing jobs. I had a job where I had to research different equipment
> from multiple companies, how it was used, where it was used, and which
> places used what types and levels of technologies. Then, I had to parse
> it all together, write a report detailing that information, and publish
> it after getting approval from my supervisor. Even if the reports DIDN'T
> include the technical information I researched (which they did), the
> whole concept lends itself to being called technical writing. Why? For
>
You could be describing a strategic document known as 'Competitive
Analysis', a business-class document if ever there was one. Nice work if
you can get it.
Competitive analysis is business intelligence--it is used to scope out
the competition. For example, when making decisions about what market to
enter, what features to offer, etc, you might order a competitive
analysis as one type of decision support.
FWIW, I'd say the value of thorough research here is high, while less
than thorough research could be potentially disasterous if an investor
went ahead with plans based on incomplete research.
Ned Bedinger
doc at edwordsmith.com
More information about the TECHWR-L
mailing list