Business and Technical Writing: An Overview

advertisement
Business and Technical Writing: An Overview
“Don’t write merely to be understood. Write so that you cannot possibly be misunderstood.”
—Robert Louis Stevenson
12 Hallmarks of Excellence in Business and Technical Communication
(Closely adapted from Technical Communication, 7th edition, Markel; also based on guidelines provided
by Mississippi State University’s Shackouls Technical Communication Program)
1. Honesty: Honesty in business and technical writing is a question of ethics, safety, and legality.
2. Clarity: The goal in business and technical writing is to produce a document that is, above all,
clear and informative. Ambiguity can be dangerous for companies/customers and expensive to
rectify (also, time spent clarifying misleading, inaccurate, or unclear information for customers
sacrifices productivity). Always use the simplest, most accurate word, phrase, design, or
graphic. Be consistent but not repetitive. Use the same name for a person or object every time,
but do not start more than two sentences the same way (e.g., “This is…, This is…”), which makes
your writing sound repetitive.
3. Accuracy: Major and sometimes minor inaccuracies can be dangerous for companies/customers
and damaging to a writer’s credibility. Check your facts repeatedly, and make sure your coauthors fact check, too. Remember, even if you did not write every section of a document, you
are still responsible for any document that has your name attached to it.
4. Comprehensiveness: Be thorough. Readers will not mind additional details if your design
allows for navigating around them. Documents should provide all the necessary information
that the reader needs to understand the document thoroughly, such as background, context,
and relevant details. Reserve details for appendices. Give your reader a choice about whether
or not to read all the details.
5. Conciseness: Never use two words where one will do. Make your main points early, keeping in
mind your readers’ interests. Avoid asking, “What do I want to communicate?” Instead, ask
yourself, “What do my readers need to know about this subject?”
6. Accessibility: Documents should be written and organized to allow the reader to use, navigate,
and understand information quickly. Effective techniques include adding white space, a table of
contents, an index, tabs, a glossary, etc. Fill a document’s section only with the information that
should logically be there. Inevitably, your readers will use skimming and scanning techniques to
identify the information that is most relevant to them. Do not fight this tendency by readers;
facilitate it.
7. Professional appearance: Always strive for an attractive, consistent, well-spaced design. The
good first impression this creates is invaluable. Page design plays a key role in accessibility. Ask
yourself if the document looks inviting and presents information clearly. Also, the document
should abide by conventional standards in your field or company. Most companies will have
standard templates for reports, memos, PowerPoint presentations, etc. that are made available
to the public. These guidelines typically also govern the use of company logos, trademarks, etc.
Learn and follow these guidelines.
8. Correctness: Eliminate mechanical and stylistic errors. They distract readers, invite ambiguity,
and damage credibility. Revise for content as well. The best writers revise several times before
a paper is “finished.” At the same time, do not let perfectionism stand in the way of getting
your writing into the hands of the reader. A famous writer once said, “I never finish a piece. I
surrender it.” Proofread at least three times, keeping in mind that this step is ultimately your
responsibility, not the typist’s, printer’s, graphic designer’s, or copy editor’s.
9. Flow: First, jot a brief outline or a list of ideas you THINK you want to cover in the document.
Then group related ideas together and cross out unnecessary ideas, topics that do not quite fit,
and repetitions. These natural groups of related ideas will show you where to put headings and
sub-headings and will point to an introductory statement. All major points in your document
should flow from the introduction. Make sure that all sentences in a paragraph lead into one
another and that they fully support the topic sentence of that paragraph. Connections between
ideas should be obvious, but help readers by providing transitional words and repeating key
terms. Use signposts and transitional words (however, moreover, first, second, third) to point
out changes in direction of thought. Finally, in longer documents, use the conclusion to recap
major points. By the time your readers have reached page 5, they will have already forgotten
page 1.
10. Illustrations: Clearly label graphics in business or technical writing. Within the text, refer to,
explain, and cite (if necessary) every table, chart, figure, illustration, photo, or other graphic you
use. Write captions that explain the significance of illustrations and tables. Instead of “See
Figure 4,” state what the reader will see there: “As Figure 4 shows, X increases directly with Y.”
11. Tone: Get in the habit of writing a little more formally than you speak in everyday
conversations. Avoid contractions, slang expressions, clichés, and euphemisms. Remember that
formality does not mean using fancy words, the use of which negates your goals of simplicity
and immediate comprehension. Avoid “five-dollar words” in business and technical documents.
12. Read, read, read! One of the best ways to improve your writing is to read. Not everything that
is published is well written, but by reading, you pick up various styles, tones, and organizational
methods. Good writers will help you hone your own style, and bad writers will demonstrate
what NOT to do.
Remember this simple rule of thumb: Pamper your readers. Make your job hard to make theirs easy!
The Big 16: A Grammar and Mechanics Checklist
(From Technical Communication, 7th edition, Markel; and BCOM, 5th edition, Lehman & Dufrene)
During the revision process, ensure that your writing is mechanically and stylistically sound using these
basic rules. Go through this checklist BEFORE submitting a final draft for a grade in this class. This list is
not exhaustive but should help you catch many common errors.
1. Lists: Number lists to show chronology or rank of importance within the listed items; otherwise,
use bullets for listed items (or shadow boxes for checklists). Lists should contain no more than
8-10 items and must be preceded by a lead-in statement (usually followed by a colon). Listed
items should be punctuated consistently and structurally parallel (see number 4).
2. Flow: To improve flow, vary sentence length and type, do not needlessly repeat key terms or
information (use a pronoun instead, as long as it is not a vague pronoun), ensure sentences
build logically upon one another, and use transitional words like “also,” “next,” “however,” and
“in addition.” Read the document aloud to check for flow. If your tongue trips over a sentence,
it often means that sentence is difficult to comprehend during initial reading.
3. Real subject/real verb: Avoid weakening a verb by nominalizing it (converting it into a noun).
Avoid expletives (a sentence that postpones the subject by beginning with “there” or “it” and a
form of the verb “be”—am, is, are, was, were, be, being, been), such as, “It was John who won
the award last year” or “It is probable the request would have angered management.”
4. Parallel elements/parallel structure: When listing items in a series, put them in a similar
pattern (e.g., “I like playing computer games, comic books, and to go to the movies” should be “I
like playing computer games, reading comic books, and going to the movies” or “I like computer
games, comic books, and movies”).
5. Modifiers: Do not set off restrictive modifiers with commas because they are vital to the
sentence’s main idea, but do set off nonrestrictive modifiers, which add extraneous information.
Avoid misplaced modifiers (which are incorrectly placed in the sentence), dangling modifiers
(which lack a clear, logical referent entirely), and squinting modifiers (which could modify one or
two referents in the same sentence, thus creating ambiguity for the reader).
6. Passive voice/active voice: Opt for active voice whenever possible. (Active voice involves the
subject performing the action, such as in “Kelly studied the material and presented her findings
to management.” Passive voice involves the subject having the action performed to it, such as in
“The results were studied and presented to managers by Kelly.”)
7. Be specific: Choose words that cannot be misinterpreted (e.g., “the right button” has two
possible interpretations).
8. Jargon/shoptalk: Avoid “shoptalk” whenever possible, and, when using unfamiliar terms, be
sure to explain them thoroughly. Define acronyms upon first use in business or technical
communication, especially because acronyms do not necessarily translate interculturally. Jargon
can come across as condescending or intimidating, not to mention confusing, to the reader.
9. Positive constructions/negative constructions: Use positive constructions over negative
constructions to tell what something IS instead of what it IS NOT. For example, instead of
10.
11.
12.
13.
14.
15.
16.
writing that an employee’s performance is “not acceptable,” write “unacceptable.” The term
“positive construction” has nothing to do with having a positive attitude or a positive result.
Long noun strings: Avoid these when possible, since they are hard to comprehend at first
glance and require second or third readings, thus wasting the reader’s time (e.g.,
“preregistration procedures instruction sheet update” is better written as “an update of the
instruction sheet for preregistration procedures”).
Inoffensive language: Avoid the generic “he,” which can be offensive to women, even if
unintentionally so. Instead, use “he or she,” alternate between the generic “he” and the generic
“she” in lengthy documents, or opt for genderless pronouns (like plural pronouns). However, do
not use a plural pronoun (“they,” “their”) to refer to a singular antecedent, which violates rule
12.
Pronoun-antecedent disagreement: Always ensure that your pronoun and its antecedent (the
noun that the pronoun replaces) agree in number. For example, “An athlete has a heavy burden
on their shoulders” should be “Athletes have heavy burdens on their shoulders.” “Everyone
needs to take their seats” should be “Everyone needs to take his or her seat.”
Semicolons/colons: Use semicolons to join together independent clauses (words that can stand
alone as complete sentences), avoiding using conjunctions (FANBOYS—for, and, nor, but, or,
yet, so) with semicolons. Semicolons are also useful for separating listed items that already
contain commas, as in “The students were from Slidell, LA; Huntsville, AL; Starkville, MS; and
Knoxville, TN.” Colons are used to set apart elements of a sentence, such as listed items, and
should be preceded by independent clauses.
Prepositions: Avoid ending sentences with prepositions. Find a list of common prepositions in
your grammar handbook or at http://owl.english.purdue.edu/owl/resource/730/1/.
Split infinitives: Infinitive verbs (to work, to run, to prepare, etc.) should not be split apart. For
example, “to quickly work” should be revised as “to work quickly.”
Spell check/grammar check: These tools are excellent, but keep in mind that they cannot catch
many common mistakes. For example, spell check misses homonym errors (which-witch,
principle-principal, led-lead, its—it’s), and grammar check frequently confuses subject-verb
agreement. Read and carefully consider the suggestions offered by your spell check and
grammar check programs.
Download