RE: Pet Peeves

Subject: RE: Pet Peeves
From: "Ladonna Weeks" <ladonna -dot- weeks -at- comtrak -dot- com>
To: "'Chris Borokowski'" <athloi -at- yahoo -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 14 Mar 2007 12:23:35 -0500

This reminds me of when we were training some users in Japan.
They knew some English but not the word "twice". So when we
wanted them to press the F8 key a second time, we learned to say
to press it "two times".

Ladonna Weeks
ladonna -dot- weeks -at- comtrak -dot- com
cell: 314-210-1652

-----Original Message-----
From: Chris Borokowski [mailto:athloi -at- yahoo -dot- com]
Sent: Tuesday, March 13, 2007 10:31 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: Pet Peeves

Please, no politics on the list. It polarizes workplaces into
paranoia and makes people afraid to speak.

I would suggest that people use fewer colloquialisms in general,
as they are not accessible to any reader who hasn't encountered
them before. The term "whole enchilada" might make sense to
someone from Texas, for example, but could baffle a New Yorker.

Whenever I find myself using colloquialisms in documentation, I
have to stop and ask whether or not I'm explicitly describing a
process or using a convenient phrase to gloss over lack of

--- "Flood, Donna" <DFlood -at- eoriginal -dot- com> wrote:

> Everybody who makes their living using language really should
take it
> upon themselves to become informed about sexist and racist
> and delete it from their vocabulary.

Now that's room service! Choose from over 150,000 hotels in
45,000 destinations on Yahoo! Travel to find your fit.


Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output.

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual:

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

RE: Pet Peeves: From: Flood, Donna
RE: Pet Peeves: From: Chris Borokowski

Previous by Author: RE: GUI Hierarchy
Next by Author: Context sensitive webhelp
Previous by Thread: RE: Pet Peeves
Next by Thread: Debunking myths and nonsense (was RE: Pet Peeves)

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

Sponsored Ads