Re: Marcom as TechCom
Isn't this what's commonly referred to as "task-oriented documentation"?I don't think so. You can give descriptions of task after task without ever mentioning why someone would want to do each task - I've seen dozens of manuals that do exactly that.
We receive requirements documents from our customers, and that's what I
use as a foundation for our user documentation. The user guide does not
consist of a list of windows and explanations of fields, it consists of
process maps and procedures that tell how they can implement FeatureA or
FeatureB, to accomplish task1 and task2 of their daily job.
To take a simple example, you could explain how to use styles in a word processor, but if you don't explain why someone might want to use styles, then the information is of limited use.
--
Bruce Byfield bbyfield -at- axionet -dot- com 604.421.7177
http://members.axion.net/~bbyfield
"Here's to you, whoever you may be,
You who held me up while I was sinking in the sea,
If you were in Kiltartan, and me in Katmandu,
I still would not forget you, and I'd do the same for you."
- OysterBand
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Order RoboHelp X3 and receive a $100 mail-in rebate, plus FREE RoboScreenCapture, WebHelp Merge Module and iMarkupSoftware, for a total giveaway value of $473! Order here: http://www.ehelp.com/techwr-l
Help celebrate TECHWR-L's 10th Anniversary starting this month!
Check out the contests at http://www.raycomm.com/techwhirl/special/contests/
Happy birthday to you, happy birthday to you, happy birthday 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.
References:
RE: Marcom as TechCom: From: Anita Legsdin
Previous by Author:
Re: Question-How independent is "independent contractor status?"
Next by Author:
Re: Marcom as TechCom
Previous by Thread:
RE: Marcom as TechCom
Next by Thread:
RE: Marcom as TechCom
Search our Technical Writing Archives & Magazine
Visit TechWhirl's Other Sites
Sponsored Ads