![]() |
Basics
for Communicating Clearly
|
| Questions or comments? Contact Linda Shacklock. |
|
|
||
|
a,
an [all
topics]
Choose
the article a or an by how you normally pronounce the term
that follows.
Use a
before a consonant sound.
a historic
document, a human, a uniform surface, a U.S. trade agreement
Use an before a vowel
sound.
|
||
|
accept,
except [all
topics]
accept (verb) = to take when offered except
(preposition) = with the exclusion or exception of
The project
manager accepted all the test results except those from the island of Atlantis.
except
(verb) = to exclude or omit
Tip: Because few readers understand except as a verb, we should avoid using it. |
||
|
adapt,
adopt [all
topics]
adapt = to make fit, to modify The company adapted the software to the product that it adopted. |
||
|
affect,
effect [all
topics]
affect (verb) = to influence, to have an effect on effect (noun) = the result
of an action
effect (verb) = to bring
about, to cause, to achieve
Tip: Because few readers understand effect as a verb, we should avoid using it. |
||
|
amount
of writing
amount of time amount of population number (noun) = a term that
relates to separate, countable units
Tip:
"How much?" Use amount.
|
||
|
assure,
ensure, insure [all
topics]
Use assure to mean removing doubt from a person's mind. Use ensure to mean
making things certain or safe.
Use insure with regard
to insurance.
|
||
|
Avoid
Useless Words [all
topics]
any, character,
in order, it is, located, matter of, nature, possible, proximity, purpose
of,
To achieve clear, concise writing, avoid words that add no meaning. You can usually delete or rewrite to avoid these words: serve to, somewhat, there are, there is, various, very |
||
| Commas
—
a partial guide to using commas [all
topics]
Tip:
Read the sentence to yourself, and use a comma where you need a short pause
between thoughts or items in the sentence.
Use comma(s) to set off mildly interrupting phrases. Jane, unlike Sue, now attends college. In Arizona, as in Montana, the sky is usually clear blue, not gray. Use a comma after an introductory
phrase.
Use a comma after an introductory
clause.
Use a comma before a coordinating
conjunction between independent clauses.
Use a comma in direct address.
Use commas between items
in a series.
Do you want a hamburger, tacos, or pizza? Tip:
To prevent ambiguity or confusion, always use the comma before the
and.
Use commas between adjectives
that modify a noun.
Don't use commas between
adjectives that modify each other.
Tip:
Notice that using and between adjectives would
not make sense:
She likes bright and yellow and happy faces to decorate her room. Don’t
join independent clauses with a comma.
Wrong: I brought you rice crackers again, do you still like them? |
||
|
could've,
should've, would've, may've, might've [all
topics]
Mary should've
gone to college.
could've = contraction of
could
have
should've = contraction of should have would've = contraction of
would
have
may've = contraction of may
have
might've = contraction of
might
have
Tip: The forms could of, should of, would of, may of, and might of are never correct. |
||
|
criteria = the plural form
All three criteria are important to the decision. |
||
|
data
—
singular or plural? [all
topics]
Grammar Central agrees with
Patricia T. O'Conner in her book Woe Is I: The Grammarphobe's Guide
to Better English in Plain English:
However, if controlling style
guides require using data as a plural noun, this usage note in the
Merriam-Webster online dictionary (http://www.merriam-webster.com/dictionary)
explains both constructions as standard:
|
||
|
e.g.,
i.e. [all
topics]
Avoid using the abbreviations
e.g.
("for example") and i.e. ("that is"), because most readers don't
know the difference between them.
|
||
|
farther,
further [all
topics]
further = a term that relates
to abstract quantity or degree
farther = a term that relates
to physical, measurable distance
We will discuss the issue further at the staff meeting. |
||
|
her,
hers [all
topics]
Are your
test results better than hers?
her, hers = possessive forms
of she
Tip:
The form her's and the form hers' are never correct.
|
||
| I/me,
he/him, she/her, we/us, they/them [all
topics]
(This piece is based on an article that Linda Shacklock originally wrote for the STC Metro Baltimore Chapter newsletter and that was reprinted in Technical Communication, Third Quarter 1990.) Would we ever say “Jack brought
books for I and Amy”?
Personal pronouns (other than you) aren’t common in technical communication, but using them correctly in speech and in writing is worthy of the professional communicator’s attention. I have a two-part theory for why normally competent speakers of English have trouble with personal pronouns, especially I/me, he/him, and she/her, not so much we/us and they/them:
He [single subject] brought books for me [single object].Compound objects, though, sometimes fool even the most careful speakers and writers. These examples of compound objects are correct: He brought books for you and me. [Never correct: …for you and I.]If we can’t get the “easy” stuff right (pronouns), why should our employers, our clients, and our SMEs think we can get the technical stuff right? |
||
|
into,
in to [all
topics]
Use into to indicate
changing the form of something.
Use the word into
to indicate entering something.
When the ice turns into water, dump it out. If the one-person project turns into a two-person project, we'll adjust the estimated hours. If you run into a problem, ask for help. Try not to drive into the garage wall. If you can drop the word
in
but keep the essential meaning, you need the two words in to.
With
thanks to Patricia T. O'Conner's book Woe Is I: The Grammarphobe's
Guide to Better English in Plain English.
|
||
|
its,
it's [all
topics]
it's = contraction of it
is or it has
its = possessive form of
it
The results of the second test indicate it's [it is] valid. It's [it has] been a productive meeting. Tip: If you can substitute it is or it has for its in a sentence, the term you need is it’s. Tip:
The term its' is never correct.
|
||
|
less writing
less time less population less fat fewer (modifier) = a term
that relates to separate, countable units
Tip:
"How much?" Use less.
|
||
|
-ly
ending [all
topics]
Wrong:
a simply-stated instruction
Words that end in -ly
are usually adverbs.
Right: a simply stated instruction |
||
|
Our schedules
must match the needs of the project.
Are your test results better than ours? Tip:
The form our's and the form ours' are never correct.
|
||
|
Plural
Abbreviations [all
topics]
ATM, ATMs
Although some sources recommend
using an apostrophe to make an abbreviation plural, most technical communicators
use the clean style of omitting the apostrophe in a plural abbreviation.
GIF, GIFs ICBM, ICBMs JPEG, JPEGs MBA, MBAs PC, PCs PDF, PDFs |
||
|
Plural
Nouns [all
topics]
book,
books
More and more these days,
we see an apostrophe mistakenly used to make a noun plural (more than one).
Don't do that!
bus, buses computer, computers day, days dollar, dollars glass, glasses Jones family, the Joneses story, stories yes and no, yeses and nos |
||
|
Possessive
Plural Nouns [all
topics]
the men's
basketball team
For a plural noun that does
not end in s, add apostrophe plus s to make the noun possessive.
For
a plural noun that ends in s, add just an apostrophe to make the
noun possessive.
|
||
|
Possessive
Singular Nouns [all
topics]
one bus's
driver
No matter which letter ends
a singular noun, add apostrophe plus s to make the noun possessive.
one child's jacket one company's logo one glass's rim Mr. Jones's car one man's basketball Phoenix's mayor |
||
|
respective,
respectively [all
topics]
The temperatures
were 34, 59, and 42 at 0600, 1400, and 2200 hours, respectively.
To help users easily understand content, avoid the terms respective and respectively. Hard to grasp:
Better:
The temperatures
were 34 at 0600 hours, 59 at 1400 hours, and 42 at 2200 hours.
|
||
|
than,
then [all
topics]
The manager's
salary is greater than mine.
Use the word than
to compare one thing to another.
Saving money is easier said than done. Also use than to indicate difference of some sort. She'd like to be anywhere than at the office. Use the
word then to indicate a sequence of time.
|
||
|
their,
theirs, they're [all
topics]
Are his
test results better than theirs?
their, theirs = possessive
forms of they
Tip: The form their's and the form theirs' are never correct. they're
= contraction of they are
Tip:
If you can substitute they are for their in a sentence, the
term you need is they're.
|
||
|
there's,
there're [all
topics]
There's
[There is] one task [singular noun] left to do.
there's = contraction of
there
is
Tip: The form theres and the form theres' are never correct. there're
= contraction of there are
|
||
|
Use
Strong Verbs [all
topics]
Strong:
To achieve clear, concise writing, avoid smothering strong verbs as objects of weaker verbs. Smothered:
inspect, measure, consider |
||
|
who
[all
topics]
Please
determine who the leaders are.
Like the pronouns I, he,
she, we, and they, the pronoun who is used as the subject
of a verb.
The manager will decide who goes to the conference. The writers who Donna said are good stay too busy to help.
|
||
|
whoever
[all
topics]
Whoever
is in charge of the meeting needs to publish the agenda.
Like the pronoun who, the pronoun whoever is used as the subject of a verb, but whoever leads to cumbersome constructions and is best avoided. [Better: The person (who is) in charge of the meeting needs to publish the agenda.] Whoever calls first gets the job. [Better: The applicant who calls first gets the job.] Whoever the leaders are will get the praise or the blame. [Better: The leaders will get the praise or the blame.] The manager always selects whoever he thinks is most qualified. [Better: The manager always selects the person (who) he thinks is most qualified.] Donna will assign the project to whoever has time to do it. [Better: Donna will assign the project to the writers who have time to do it.]
|
||
|
whom
[all
topics]
Please
tell me when you decide whom [object of "will hire"] you will hire.
Like the pronouns me,
him, her, us, and them, the pronoun whom is used as an
object, not a subject.
Because the use of whom can be difficult and can sound stilted even when used correctly, try to avoid whom by replacing it with a noun phrase. To
which
person should I give the meeting agenda?
Please
tell me when you decide which candidate you will hire.
He brought the books for which student?
|
||
|
whomever
[all
topics]
Give the
meeting agenda to whomever you see first.
Like the pronoun whom, the pronoun whomever is used as an object, not a subject, but whomever leads to cumbersome constructions and is best avoided. [Better: Give the meeting agenda to the first person (whom) you see.] We'll hire whomever you find most qualified. [Better: We'll hire the applicant (whom) you find most qualified.] We'll heap praise on whomever the boss identifies. [Better: We'll heap praise on the person (whom) the boss identifies.]
|
||
|
who's,
whose [all
topics]
whose = possessive form of
who
who's = contraction of who
is or who has
Whose schedule shows some free time? Tip:
If you can substitute who is or who has for whose
in a sentence, the term you need is who's.
|
||
|
your,
yours, you're [all
topics]
Tip:
The form your's and the form yours' are never correct.
your, yours = possessive
forms of you
you're
= contraction of you are
Tip:
If you can substitute you are for your in a sentence, the
term you need is you're.
|
||
|
|