Re: Clarity or Talking Down?

Subject: Re: Clarity or Talking Down?
From: Tracy Boyington <tboyi -at- OKVOTECH -dot- ORG>
Date: Wed, 28 May 1997 10:46:47 +0000

> 2. When a command is supposed to by typed, put the word Type "xxxxx"
>
> To make a long story longer, she made the comment that we did not
> have to put the clarity in Step 2 that I suggested. She goes on to
> say that if the developer's need to be told that, then "We hired the
> wrong person!"

Kevin, the answer to this debate may be in your first paragraph:

>The developers complained
>that the procedure didn't work.

If the developers understand *without* the changes you suggested in
step 2, then it isn't necessary. But if they're still having
problems, it should be easier to justify that extra measure of
clarity.

Tracy

==========================================================
Tracy Boyington tracy_boyington -at- okvotech -dot- org
Oklahoma Department of Vocational & Technical Education
Stillwater, Oklahoma, USA
http://www.okvotech.org/cimc/home.htm

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: CBT (Computer Based Training)
Next by Author: [no subject]
Previous by Thread: Job Postings, a comment
Next by Thread: Clarity or Talking Down?


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


Sponsored Ads