RE: Generally, what do you think of generally?

Subject: RE: Generally, what do you think of generally?
From: "Ackerson, Allan" <aackerson -at- logicon -dot- com>
To: "Blaine, Karen L." <karen -dot- blaine -at- unisys -dot- com>, TECHWR-L <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 8 Feb 2000 06:10:08 -0800

Kill all adverbs in technical writing. By definition, technical writing is
precise. If you can't express a concept without generalizations become a
novelist. See Strunk & White's "The Elements of Style" for the best short
treatment of clear writing.

Cheers!
Al

-----Original Message-----
From: Blaine, Karen L. [mailto:karen -dot- blaine -at- unisys -dot- com]
Sent: Tuesday, February 08, 2000 6:55 AM
To: TECHWR-L
Subject: RE: Generally, what do you think of generally?


For what it's worth...
While there are times when the use of "typically" and "generally" may be
appropriate, I find I can usually avoid them. My gut feeling when reading a
document using those words is that the material comes across as
condescending. I often see "typically" and "generally" in documents written
by programmers, especially the prima donnas. Each word places a slightly
judgmental twist on the context of the rest of the sentence, implying that I
should see what is obvious and that I may be too stupid or ignorant to do
so.


-----Original Message-----
From: anonfwd -at- raycomm -dot- com [mailto:anonfwd -at- raycomm -dot- com]
Sent: Monday, February 07, 2000 7:36 PM
To: TECHWR-L
Subject: FWD: Generally, what do you think of generally?



Hi everyone.
I won't take up too much time, I just have one question.
My company has several products all of which have a few books written
about them. As you might guess, the manager wants all of the books to look
like
they were written by the same person (let's not go there). I am not
telling you this because I want to gripe/question about that issue. I am
asking
what you think about writing the books using a term like typically or
generally, prior to telling what the reader/user should do. For example:
Typically, on a rainy day you use an umbrella.
rather than:
On a rainy day you use an umbrella.
My thoughts/concerns are that the former, when used in real life
situations, is too wishy-washy. If it is something that they may or may not
do (it is
their call), I think they will be smart enough to not do it if they want
to, even if you use directive language.



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Forwarded anonymously on request. If you want the
original poster to see your response, you must reply
to the TECHWR-L list. All direct replies to this
message are automatically discarded. Contact Eric
ejray -at- raycomm -dot- com with questions.



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Sponsored by Weisner Associates Inc., Online Information Services
Training & consulting for RoboHELP, Dreamweaver, HTML, and HTML-Based Help.
More info at http://www.weisner.com/train/ or mailto:training -at- weisner -dot- com -dot-

Your web site in 32 languages? Maybe not now, but sooner than you think.
Contact ForeignExchange for the FREE paper, "3 steps to successful
translation management" (http://www.fxtrans.com/3steps.html?tw).

---
You are currently subscribed to techwr-l as: karen -dot- blaine -at- unisys -dot- com
To unsubscribe send a blank email to leave-techwr-l-20227V -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.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Sponsored by Weisner Associates Inc., Online Information Services
Training & consulting for RoboHELP, Dreamweaver, HTML, and HTML-Based Help.
More info at http://www.weisner.com/train/ or mailto:training -at- weisner -dot- com -dot-

Your web site in 32 languages? Maybe not now, but sooner than you think.
Contact ForeignExchange for the FREE paper, "3 steps to successful
translation management" (http://www.fxtrans.com/3steps.html?tw).

---
You are currently subscribed to techwr-l as: aackerson -at- logicon -dot- com
To unsubscribe send a blank email to leave-techwr-l-19887F -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.




Previous by Author: Re: OT: How would you pronounce this word...? (no, it's not in a dictionary)
Next by Author: RE: Generally, what do you think of generally?
Previous by Thread: RE: Generally, what do you think of generally?
Next by Thread: Re: Generally, what do you think of generally?


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

Sponsored Ads


Sponsored Ads