Re: Try selling the sizzle of what you do.

[John Posada <john -at- tdandw -dot- com>]

> Which leads to the inevitable question "Do you want me to document it the
> way the spec says it ought to work, or the way it actually works?"

Always how it currently works.

Had a product manager that wanted me to change the online help system I did
for a product. I'd written how to accomplish something, but it took WAY more
steps than it should have and was basically a workaround. If the user did it
the way they SHOULD have, the feature would not have worked...it had to do
with importing a prior dataset after an upgrade.

In short, I said no. He said yes. I said no. We appealed to a much higher
authority.

Boy, was the project manager upset with the decision. OTOH, the process got
redesigned and only then was I able to document it the way he wanted.

John Posada
Senior Technical Writer
john -at- tdandw -dot- com


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
Buy or upgrade to RoboHelp X3 today and receive the WebHelp
Merge Module for FREE ($299 value). RoboHelp X3's all-new
features include conditional text, completely re-engineered
printed documentation output, Context-sensitive Help Toolkit,
single-source layouts, and more!
Order online today at http://www.ehelp.com/techwr-l


---
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
http://www.raycomm.com/techwhirl/ for more resources and info.