Re: Survey Question

Subject: Re: Survey Question
From: Keith Hood <klhra -at- yahoo -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 26 Jul 2006 13:06:46 -0700 (PDT)

So far, it's never really happened. There have been a
few times when I was asked to document something from
the specs. I've always been successful when I pointed
out that specs are never up to date with the genuine
state of the product, and that using the UI always
entails steps that are not detailed in the
requirements or the use cases.

You need to ask them, why in the world do they expect
you to not need access to the software? Do they really
believe that you can provide high-quality
documentation of something you can't use? Maybe
they're having a problem with security clearances
needed, or if there is a limited number of seat
licenses or something like that. If their no-need
expectation is based on resource limitations, no big
problem. But if it's based on them thinking you can do
a good job writing about something you can't look at .
. . well, the word for that kind of writing is
"fiction." You might want to check the source of this
expectation because it may indicate a problem in their
understanding of your work process, and that could
cause you other problems later.


Keith Hood
Senior (only) tech writer
ACS, Inc.

Do You Yahoo!?
Tired of spam? Yahoo! Mail has the best spam protection around

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

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

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.

Survey Question: From: Diana Ost

Previous by Author: Re: Getting rid of the manual
Next by Author: Asking for help in designing a new document
Previous by Thread: Re: Survey Question
Next by Thread: Re: Survey Question

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

Sponsored Ads