TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:RE: Generally, what do you think of generally? From:"Blaine, Karen L." <karen -dot- blaine -at- unisys -dot- com> To:"WinHelp List (E-mail)" <TECHWR-L -at- LISTS -dot- RAYCOMM -dot- COM> Date:Tue, 8 Feb 2000 08:54:53 -0500
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.