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: Manuals Written in Non-American English From:Jane Bergen <janeb -at- AIRMAIL -dot- NET> Date:Tue, 20 Aug 1996 20:18:41 +600
On 20 Aug 96 at 16:53, Chris Hamilton wrote:
> What things are generally done in manuals written for the USA that
> don't work well for non-American English speakers? (Aside from the
> normal, generally-accepted conventions for user documentation, if
> such things exist.)
In my "previous life" I taught English as a Second Language (ESL). I
haven't any great revelations specific to technical writing, but I
know a couple of things that non-native speakers find difficult.
First, don't use contractions. Usually we avoid those in tech writing
anyway, but just in case.... spell it out.
Second, avoid tag questions. Japanese is one of the languages that
have a really hard time answering questions like: "You're happy,
aren't you?" Their language system has no constructs like this. A
"no" answer would contradict the first part but a yes answer the
Third, keep your sentences short and generally subject-verb-object.
Even if your target language is different (such as
subject-object-verb), at least the speakers can switch gears easily
enough when you're consistent.
Fourth, try to learn as much about the audience as possible. Will
they all be homogenous (same culture, same language group)? Will they
have had English classes? Are they literate in their own language? Do
they use a different alphabet? Obviously, if you are distributing all
over the world, you've got problems.
janeb -at- airmail -dot- net
janebergen -at- aol -dot- com
TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-