RE: Editing Guides

Subject: RE: Editing Guides
From: "Martinek, Carla" <CMartinek -at- zebra -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 2 Nov 2007 14:41:09 -0500

-----Original Message-----
A client told me: "that" and "the" should never follow each other.
Ex: "verify that the service has started."

It may be that "that" is one of my subconscious writing ticks. Without
the "that," i feel that the sentence doesn't flow smoothly and that
"that" sets up the clause "the service has started."

In English, we tend to drop many parts of speech, especially when
speaking. If you are writing for translation, or writing for an
international audience, then leaving out parts of speech can reduce
clarity for non-native English speakers.


Do Not Leave Out Necessary Words
The English language allows us clearly convey our intentions
even when
we omit certain words, such as relative pronouns (who, whom,
that, which),
prepositions, and parts of verbs. In other languages these words
required and must be included in documents that will be

Use Articles Whenever Possible.
An article is a word used to indicate a noun and to state its
For example, in English, the definite article is 'the' and the
articles are 'a' and 'an'. Use of articles reduces ambiguities
and gives
you better translation results.


This email and any files transmitted with it are confidential, and may also be legally privileged. If you are not the intended recipient, you may not review, use, copy, or distribute this message. If you receive this email in error, please notify the sender immediately by reply email and then delete this email.

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

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.


Editing Guides: From: Jill Mohan

Previous by Author: Re: Re-upping STC membership?
Next by Author: RE: Primordial or Primitive objects for installation and configuration
Previous by Thread: RE: Editing Guides
Next by Thread: RE: Editing Guides

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

Sponsored Ads