Re: inhouse vs outside doc (RE: Good/bad docs)

Subject: Re: inhouse vs outside doc (RE: Good/bad docs)
From: Connie Fabian-Isaacs <cfisaacs -at- VISIONAEL -dot- COM>
Date: Fri, 7 Aug 1998 14:33:01 -0500

Dan, you raised some interesting questions. The most compelling was the
last one:

<
So, I'm curious about the comparisons between the two:
* Do the constraints and difficulties experienced by both cancel each
other out, so that we're back to a level playing field?
* Do the advantages tend to cancel each other out, so that we're back to
a level playing field?
* If we're back to a level playing field, then how is it that folks tend
to turn to outside doc to help them with a program, rather than the
inhouse doc? What does the outside doc do that we inhouse writers should
be doing?>

I have worked both sides of the fence. For about four years I contracted to
develop a help system for a company that produced internal software that
ultimately found it's way to a limited commercial market. I telecommuted
from my home. I found it an exhilerating experience. My only frustration
being that they had no one really "in charge" of the project who had any
depth of understanding about what I was doing. So there was very little
appreciation for my efforts, they were just taken for granted. However,
they paid me well, so that was appreciation enough.

As for your last question...I think it's a point of objectivity. Outside
writers are not harboring any false illusions with regard to their
knowledge. They have to take the time to get to know the user base, the
product, the SMEs and everything else that pertains to the project. Now
that I'm wearing my other hat which is developing documentation from the
inside, I've noticed that I make far more assumptions in each of those
areas. Most of my assumptions are made out of necessity because I'm so very
limited timewise.

As a contractor I had a little more authority to insist that they provide
certain things that I do not have the authority to insist upon as an
internal writer.


Connie Fabian-Isaacs
Technical Documentation Specialist
VISIONAEL Corporation
(918) 663-1455 X1390 (phone)
(918) 663-1456 (fax)
cfisaacs -at- visionael -dot- com


<<application/ms-tnef>>


Previous by Author: Re: Document management tools or processes
Next by Author: Creating Wizards
Previous by Thread: inhouse vs outside doc (RE: Good/bad docs)
Next by Thread: Re: inhouse vs outside doc (RE: Good/bad docs)


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


Sponsored Ads