RE: More on Validating documentation

Subject: RE: More on Validating documentation
From: "Dick Margulis " <margulis -at- mail -dot- fiam -dot- net>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 25 Mar 2002 12:04:19 -0500

I had one contract assignment that was somewhat similar to what Kim describes (although not so extreme).

The situation was that the developers were employed by a large consulting firm that has since changed its name to protect the guilty (rhymes with an accounting firm that has been in the news lately). They were woefully behind on developing the system and under the gun to be productive at their high hourly rate.

The customer, disgusted with the consultant's progress to date, brought in a much smaller consulting firm to put together the doc team.

The developers were friendly enough in a social sense (well, most of them), but they were under strict instructions not to "waste" their precious time responding to queries from the doc team. Anything we couldn't suss out ourselves had to go up one chain and down another, with virtually no likelihood of actually getting a timely answer.

Conclusion: lousy management at all levels. We did our best in a bad situation. But if you are invited to work for someone who has a big consulting firm doing the development and you won't be part of their team--walk away.


"Kim Schaefer" wrote:

>I started a new job mid-January. This is the first job where documentation
>is totally removed from the development process. I was invited to just one
>meeting, and that was so I could take notes (which were very helpful to me).
>My questions to the SMEs largely go unanswered, are avoided, frowned upon,
>and are regarded as intrusions on their workday.

PC Magazine gives RoboHelp Office 2002 five stars - a perfect score!
"The ultimate developer's tool for designing help systems. A product
no professional help designer should be without." Check out RoboHelp at
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

Previous by Author: Re: page orientation problem when printing from pdf
Next by Author: Re: More on Validating documentation
Previous by Thread: Re: More on Validating documentation
Next by Thread: RE: More on Validating documentation

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

Sponsored Ads