Professional Documents
Culture Documents
Style Diction PDF
Style Diction PDF
Writing Styleguide
Example Example
You can choose between steak, You can submit the form upon
chicken, and fish. completion. (Correct)
John was among the candidates You may submit the form upon
chosen. completion. (Implies that you have
permission to submit the report)
And/or
Use may only when you really need
And/or is often used in legal to be tentative.
applications. Avoid using it where
either and or or will do.
Example
Because and since If you submit the form within two
weeks, you may receive approval
Avoid using since to mean faster.
becauseits ambiguous. Use
because to refer to a reason. Use
since to refer to the passage of time. Clichs
A clich is an expression that has lost
Example its originality and impact through
Because we installed a new system, overuse. Examples of clichs include
we can quickly respond to the public. busy as a bee, light as a feather,
with regard to and all things
Since we installed the new system, considered. Avoid clichs like the
our response rate has improved by plague!
five minutes.
Colloquialisms
Between Colloquialisms are conversational or
See Among and between. slang expressions like cutting-edge
technology. Avoid them as much as
Can and may possible.
Dates
Comprise
Avoid using abbreviations for
Comprise means to include or months. Dont use th or nd after a
maintain. The whole comprises the date. Only use a comma when the
parts rather than the reverse. Never day is included.
use comprised of.
Example
Example
Nov. 10th, 1997 (Avoid)
The department comprises several
workgroups. (Correct) November 10, 1997 (Preferred)
Be consistent in substituting an
apostrophe for deleted letters. Avoid
uncommon contractions, and dont
create any new ones of your own.
Examples Person
The department is responsible for Person refers to the point of view or
creating annual reports, budgets, and perspective you take when writing:
financial planning. (Not parallel) first person (I or we), second
person (you), or third person (he,
The department is responsible for she, or they). This styleguide is
creating annual reports, budgets, and written in the second person, because
financial plans. (Parallel) it addresses the reader as you.
White space is important for the
following reasons:
breaks up visual impact
visual separation of sections (Not
parallel)
visually separates sections
(Parallel)
focusing attention (Not parallel)
focuses attention (Parallel)
content is broken into smaller
chunks (Not parallel)
breaks content into smaller
chunks (Parallel)
Example
For plural nouns ending in s, form
Complete the form, then submit it to the possessive case by adding an
your supervisor. apostrophe.
Examples Example
Thank the writer for their interest. Applicants (subject) appreciate
(Incorrect) (verb) honesty (object).
Thank the writer for her interest.
(Correct) Try not to start sentences with it
Thank the writers for their interest. and therethese constructions are
(Correct) often vague and wordy, and can
usually be restructured to be much
If you drop the plate on the glass more direct.
table, it might break. (Ambiguous)
If you drop the plate on the glass
Examples
table, the plate might break. (Clear) It was not our intention to break the
If you drop the plate on the glass rules. (Avoid)
table, the table might break. (Clear) We did not intend to break the rules.
The plate might break if you drop it (Preferred)
on the glass table. (Clear)
There may be resistance to the plan.
(Avoid)
See also Gender inclusiveness.
Some people may resist the plan.
(Preferred)
Sentences
Keep sentences short and simple. Try There are several options in this
to limit them to one idea. The longer proposal. (Avoid)
the sentence, the more difficult it is This proposal presents several
to grasp. If its longer than 30 words, options. (Preferred)
consider rewriting it. Dont link
unrelated ideas together with and
or use semicolons. Spacing after a period Use a
single space to separate the end of
Structure your sentences using a one sentence from the beginning of
simple subject-verb-object sentence the next. Word processors
order. By sticking to this order, you automatically put in the required
avoid using the passive voice, use spacing at the end of sentences.
fewer words, and your sentence is Pressing the space bar twice will
easier to understand. result in twice the required spacing.
Example
The car was travelling at a speed
that would endanger lives.
The car, which was travelling at a
speed that would endanger lives,
swerved onto the sidewalk.
Duncan Kent has worked as a Since 1990, Duncan Kent & Associates
journalist, technical communicator, Ltd. has provided a full spectrum of
documentation consultant, and writing technical communication services.
instructor since graduating with a With specialists in writing/editing,
Master of Arts degree from the document production, instructional
University of British Columbia in design, and web site creation, the firm
1976. In 1990, he was awarded the has guided the development of more
designation of Certified Management than 180 manuals, courses, help
Consultant (CMC) by Canadas systems, and web sites.
governing body of management
consultants. Duncan Kent & Associates Ltd.
Suite 507, 1200 West Pender Street
Duncan is a founding member of the Vancouver, British Columbia, V6E 2S9
Canada West Coast chapter of the Tel: 604-683-3136
Society for Technical Communication
Email: duncan@techcommunicators.com
(STC) and has served as the chapters Web: www.techcommunicators.com
President. For more than 12 years he
has taught technical writing at Simon
Fraser University in Vancouver,
British Columbia, and is a member of
the Advisory Board to the universitys
Writing and Publishing Program. His
writing workshops have been offered
in almost every province and territory
in Canada, and in-house to more than
50 government and private-sector
organizations.