Re: Clarity or Talking Down?

Subject: Re: Clarity or Talking Down?
From: Estella Clifford <cliff -at- FP -dot- COM>
Date: Wed, 28 May 1997 11:48:03 EST

In reply to:
> 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!"

What happens when a new developer is hired? One who has plenty of
ability, but perhaps not familiarity with:

- the specific software tools (i.e., ClearCase) your company uses, or
- the specific procedures used at your site?

IMHO, adding your "Step 2" for clarity would make your document useful
to a much broader audience with just a little effort. It could save time
and money by getting potential new developers up to speed faster, too.

Just a couple thoughts.



Sr. Technical Writer
e-mail: clifford -at- fp -dot- com
My opinions are my own . . .

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
Search the archives at or search and
browse the archives at

Previous by Author: Re: Tech writers and ISO9000 (was Proofing docs)
Next by Author: Re: Product name = noun or adjective?
Previous by Thread: Re: Clarity or Talking Down?
Next by Thread: Re: Clarity or Talking Down?

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

Sponsored Ads