Re: Workmanship

Subject: Re: Workmanship
From: Nancy Hickman <nhickman -at- GVI -dot- NET>
Date: Mon, 6 Jul 1998 02:54:15 -0500

I do think that if you come across documentation that creates a problem
for you, that you should report it to the company. However, it doesn't
follow that you should insert yourself in the situation and say that the
writer should be "canned" or what not. It never helps to take that
particular opportunity to debut your imitation of a catty film reviewer.

But by commenting concisely, you could actually help the writer that is
on staff to get more resources allocated or a process corrected or more
training or perhaps better assistance hired. And if they didn't hire a
writer to do it, maybe this will convince them to do so and to get it
capitalized under their business plan.

I certainly, certainly can agree that glitches and problems are not
always the writer's fault. Work is often developed under many
constraints outside of the control of the writer. But raising the flag
to the company that documentation is important to you as a customer can
actually improve the situation of the writer at the company. The key is
"as a customer." How can they argue for more resource, etc, if
"everything's okay with the customer?" How often has the writer argued
for a better process or a better design only to be told that "no one's
complained yet."

--- Nancy Hickman




Previous by Author: Re: Cookie Monsters (Re: Search Engines)
Next by Author: Re: Question: Context Help for Java Apps
Previous by Thread: Re: Workmanship
Next by Thread: Re: Workmanship


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


Sponsored Ads