Re: Definition of Tech Writer, was STC is broken

Subject: Re: Definition of Tech Writer, was STC is broken
From: Ned Bedinger <doc -at- edwordsmith -dot- com>
To: Sam Beard <sbeard -at- oico -dot- com>
Date: Mon, 05 May 2008 17:47:57 -0700

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 -dot- com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.


Follow-Ups:

References:
Re: Definition of Tech Writer, was STC is broken: From: Gene Kim-Eng
RE: Definition of Tech Writer, was STC is broken: From: Lauren
RE: Definition of Tech Writer, was STC is broken: From: Sam Beard

Previous by Author: Re: classification -- was definition. . .
Next by Author: Re: What about Technical Writer vs Communicator?
Previous by Thread: RE: Definition of Tech Writer, was STC is broken
Next by Thread: RE: Definition of Tech Writer, was STC is broken


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads