Technical Report Writing and Presentations

advertisement
F a c u l t y
T h e
o f
E n g i n e e r i n g
U n i v e r s i t y o f t h e W e s t
S t . A u g u s t i n e
I n d i e s
October 1st and 2ndnd, 2005
Facilitators: Natalie Chase-Caffyn
Halcyon Lawrence
Jennifer Papin-Ramcharan
Technical Report Writing and Presentations ...................................................................... 3
Objectives ....................................................................................................................... 3
The Communication Model ............................................................................................ 3
Role of Sender............................................................................................................. 3
Role of Receiver ......................................................................................................... 3
Channel ....................................................................................................................... 3
Medium ....................................................................................................................... 5
Types of Noise ............................................................................................................ 5
Identify the 5c’s of Good Technical Communication..................................................... 5
Concrete ...................................................................................................................... 6
Clear ............................................................................................................................ 6
Concise........................................................................................................................ 7
Coherent ...................................................................................................................... 7
Contextualized ............................................................................................................ 8
The Report Writing Process ............................................................................................ 8
Four Phases ................................................................................................................. 8
Data Gathering ............................................................................................................ 8
Analyzing and Sorting Results.................................................................................. 10
Outlining the Report ................................................................................................. 10
Writing the Report .................................................................................................... 10
Parts of a Technical Report ............................................................................................... 11
Types of Abstracts ........................................................................................................ 11
Qualities of a Good Abstract......................................................................................... 12
Writing Effective Report Abstracts .............................................................................. 12
Citations ............................................................................................................................ 16
Using Good Grammar in Technical Writing .................................................................... 20
Sentence Construction .................................................................................................. 20
Sentence Structures ....................................................................................................... 22
Punctuation ................................................................................................................... 23
Defining Grammar ........................................................................................................ 27
Common Grammatical Errors ................................................................................... 27
Technical Oral Presentations ............................................................................................ 33
Checklist for Technical Presentations ............................................................................... 34
2
Technical Report Writing and Presentations
Objectives
Identify Elements of Good Technical Communication
Identify Characteristics of an Effective Report
Identify Parts of a Technical Report
Understand Citation Standards
Use Good Grammar in Technical Writing
Develop skills for Technical Presentations
The Communication Model
Role of Sender
Encode the Message
Analyse the audience
Choose appropriate channels and media for transmission of message
Encourage feedback
Role of Receiver
Decode the message
Provide feedback
Channel
Verbal – use of words
3
Non-verbal – non-use of words
4
Medium
Verbal:
o Written – letters, proposals, reports
o Oral – presentations, seminars
Non-verbal:
o Models, Symbols
Types of Noise
Physical:
o Unexplained variation in a communication channel or random
error in the transmission of information.
Semantic Noise:
o It may be related to people's knowledge level, their
communication skills, their experience, their prejudices etc.
Identify the 5c’s of Good Technical Communication
Concrete
Clear
Concise
Coherent
Contextualized
5
Concrete
Content Concreteness refers to the proper coverage of your topics in
appropriate detail.
o Problem statement
o Outline
Grammatical Concreteness concerns the careful use of language to
express meaning.
o Paragraph and sentence structure and
o Appropriate word choice to describe and analyze your topics
effectively.
Clear
Simple, direct language
o Use of:
 directly worded sentences
 simple sentences
 Appropriate word choices
 avoiding overloaded sentences
Contextual clarity
o What prompts you to write? What is your purpose? Whose
work precedes or has influenced yours? What are the
organizational and intellectual requirements of your paper?
Use of:
o Abstracts
o Introductions that state the purpose and scope of the document
6
o Table of contents
o Problem statements
o Strategic repetition to promote structural clarity
o Graphs and tables
o Descriptive titles
o Headings
Concise
Focus on what is relevant
Draft outlines
Identify project scope
Look for sections, including appendixes, that are not essential to your
work
Substitute graphics to describe objects and processes, summarize data,
and demonstrate relationships
Carefully revise writing
Reduce or eliminate wordiness
Coherent
Coherence provides the reader with an easily followed path.
The paragraph is one of the most powerful instruments of coherence.
By organizing material into a topic sentence and supporting sentences,
paragraphs pull together material and emphasize various forms of
conceptual development.
Paragraph development strategies
o exemplification
o analysis
7
o comparison and contrast
o definition
o enumeration
o description
Contextualized
Clear objective
Delimited scope
Written with the audience in mind
The Report Writing Process
Four Phases
Gathering Data
Analyzing and sorting results
Outlining Report
Writing and Revising the Report
Data Gathering
Identify framework
Preliminary outline
Maintain orderly records of findings

Keep ongoing list of references

Consider how data can be displayed
8

Find out what existing literature says about the topic
9
Analyzing and Sorting Results
Write down significant results
Group and classify in order of importance
Select only what is relevant
Preparation of tables and figures
Outlining the Report
Write a de-limiting sentence (scope)
Consider main heading use in reports
Identify main and supporting ideas in relevant sections
Writing the Report
Writing using the scientific logic method
State the problem
Form the hypothesis
Observe and experiment
Analyze the data
Draw conclusions
10
Parts of a Technical Report
Abstract or summary
Acknowledgements
Title page
Table of Contents
List of figures graphs and tables
Introduction
Body
Conclusion
Bibliography
References
Appendix (es)
Types of Abstracts
Informational Abstract

Communicate contents of reports

include purpose, methods, scope, results, conclusions, and
recommendations

highlight essential points

are short--from a paragraph to a page or two, depending upon
the length of the report (10% or less of the report)
Descriptive Abstracts

tell what the report contains
11

include purpose, methods, scope, but NOT results, conclusions,
and recommendations

are always very short-- usually under 100 words

introduce subject to readers, who must then read the report to
learn study results
Qualities of a Good Abstract
uses one or more well-developed paragraphs, which are unified,
coherent, concise, and able to stand alone
uses an introduction-body-conclusion structure in which the parts of
the report are discussed in order: purpose, findings, conclusions,
recommendations
follows strictly the chronology of the report
provides logical connections between material included
adds no new information but simply summarizes the report
Is intelligible to a wide audience
Writing Effective Report Abstracts
Reread your report with the purpose of abstracting in mind. Look
specifically for these main parts: purpose, methods, scope, results,
conclusions, and recommendations.
Write a draft. Do not merely copy key sentences from your report.
Revise your rough draft to correct weaknesses in organization and
coherence, drop superfluous information, add important information
12
originally left out, eliminate wordiness, and correct errors in grammar
and mechanics.
Carefully proofread your final copy.
Introduction

Statement of Subject

Statement of Purpose

Statement of Organization and Scope

Literature Review
Why a Literature Review?

Demonstrates that you know the field.

Justifies the reason for your research. You have also to be able
to convince your reader that what you are doing is important
and needs to be done.

Allows you to establish your theoretical framework and
methodological focus. Even if you are proposing a new theory
or a new method, you are doing so in relation to what has been
done.
Plagiarism

To avoid plagiarism, you must give credit whenever you use

another person's idea, opinion, or theory;

any facts, statistics, graphs, drawings--any pieces of
information--that are not common knowledge;

quotations of another person's actual spoken or written words;
or

Paraphrase of another person's spoken or written words.
13
Strategies for Avoiding Plagiarism

Follow the Appropriate Style Manual for Referencing of Work

Put in quotations everything that comes directly from the text
especially when taking notes.

Paraphrase, but be sure you are not just rearranging or
replacing a few words.

Check your paraphrase against the original text to be sure you
have not accidentally used the same phrases or words, and that
the information is accurate.
Body

Experiment and Analysis Description
 Apparatus Sections
 Materials Section
 Test Procedure Section
 Symbols Section
 Errors and Precision

Results and Discussion
 Presentation of Results
 Discussion of Results
Conclusion

Summary of Results

Conclusions

Concluding Remarks
14
Guidelines for Reports
Part of the Report
General Information
Content
Quotations of more than two
lines are single spaced and
indented .5” from the Margin.
Tables or Figures should
appear closely following the text
where they are discussed. No
further than a page following.
Tables and Figures must have
descriptive titles.
Title Page
Abstract
Acknowledgements
Table of Contents
Student’s Name & ID Number
Lecturer’s Name
Title of Report
Date of Report
Should include the Purpose of
the report, Methods used in
conducting research, the results
and the significance of findings
Optional – single page
Includes all significant parts of
the report. Does NOT include
the TOC
Glossary
List of Abbreviations
List of Figures/Tables
Text/Body of Thesis
References
Appendices
Format
1.5 to double line spacing
Pagination
Roman Numerals Lowercase
Single line spacing used in Quotations,
Appendices, References
Page numbers on Top or Bottom
Right of the page
Margins- top and bottom 1”; Left 2” and
Right 1”
Tables and figures are
numbered using Arabic
numbering and separate
sequences
Typeface – 10-12 Pitch fonts
Preferably Serif font (TNR) for body text
and Sans Serif font (Arial) for Headings
Equations and Formulae must be typed,
not hand written
Centered Horizontally and Vertically on
the Page and spaced evenly
Single Line Spaced
Lower case Roman Numerals,
Page starting from 1
All front matter continues lower
case Roman Numerals, numbered
consecutively off the abstract
Each section on a new page
Chicago Manual of Style 15th
Ed.
Each appendix must have a
descriptive title
No Page Numbering
New sequence, Arabic
numbering
Generated in sequence
The list of appendices MUST appear in
the TOC
Continue sequence of Arabic
numbers
Citations
The Chicago Manual of Style presents two basic citation systems:
Documentation 1: Notes and Bibliographies (Humanities Style) The note reference follows the passage to
which it refers and is marked with a numeral. Notes are arranged numerically either at the bottom of each page
(footnotes) or at the end of the manuscript (endnotes). Notes include complete bibliographic information when
cited for the first time. The bibliography lists only sources used in writing the paper. Entries are arranged
alphabetically by author’s last name and include complete bibliographic information.
Documentation 2: Author-Date Citations and Reference List An author-date citation (Smith 1996) is placed
within the text or at the end of a quotation and complete citation information is given in the list of references at
the end of the paper. For works by two or three authors, all names are included (Jackson and Jones 1998). For
more than three authors, use the name of the first author followed by et al. (Brown et al. 1982). When citing a
specific page, figure, section or other element, the page number etc. should follow the date preceded by a
comma (Smith 1996, 42). Documentation 2 differs from the first style in the following basic ways. In the
Reference List:




Only the author's first and middle initials are given.
The date is placed immediately after the author's name.
Only the first word in a title or subtitle is capitalized, along with proper nouns and adjectives.
Quotation marks are not used to enclose titles of periodical articles, chapters, short literature etc.
Example: Stoller P. and C. Olkes. 1987. Sorcery's shadow. Chicago: University of Chicago Press.
Using Italics and Underlining in Chicago Style
"Chicago style recommends italicizing certain citation elements such as book and journal titles in printed text.
Use underlining if you instructor requires it or if your typewriter or word-processing program can't produce
italics."
Journal Article (Chicago Manual of Style, p. 569)
Note (1st):
1. Sean Hanretta, "Women, Marginality and the Zulu State: Women’s Institutions and Power in the Early
Nineteenth Century," Journal of African History 39 (1998): 389-415.
Following footnotes of the same article:
2. Hanretta, 389.
Bibliography:
Hanretta, Sean. "Women, Marginality and the Zulu State: Women’s Institutions and Power in the Early
Nineteenth Century." Journal of African History 39 (1998): 389-415.
Authored Book (Chicago Manual of Style, p. 529)
Note:
7. Gilbert Herdt, Same Sex, Different Cultures: Exploring Gay and Lesbian Lives (Boulder, Colorado:
Westview Press, 1997), 32.
Following footnotes for the same book:
Ibid ("in the same place") is used to refer to a single work cited in the note immediately preceding:
8. Ibid
When the work is cited earlier but not immediately preceding:
Herdt, 32.
More examples.
Bibliography (one author):
Herdt, Gilbert. Same Sex, Different Cultures: Exploring Gay and Lesbian Lives. Boulder, Colorado:
Westview Press, 1997.
Note (three or more authors):
9. Mary Jones et al., A History of the World (Bellingham: From the Beginning Press, 2000).
Following footnotes for the same book:
10. Jones et al., History of the World, 17.
Bibliography (three or more authors):
Jones, Mary, Frank Smith, Alex Jackson and Sarah Pope. A History of the World. Bellingham: From the
Beginning
Press, 2000.
For works having more than three authors, a note citation should give the name of the first author
followed by "et al" or "and others." The bibliography citation should list all the authors.
Electronic or Online Book
Note:
13. Barry J. Gibbons, Gender in Mystical and Occult Thought, (New York: Cambridge University Press,
1996), NetLibrary, 14 February 2000.
17
Entry from an Encyclopedia or Dictionary (familiar)
Note:
13. Encyclopedia Americana, 11th ed., s.v. "impeachment."
(Note: s.v. stands for sub verbo, "under the word.")
Bibliography: Well known reference books are usually not listed in bibliographies.
Entry from an Online Encyclopedia or Dictionary (familiar)
Note:
14. "Salish," Britannica Online, <http://www.eb.com:180/cgi-bin/g?DocF=micro/520/47.html >
(15 February 1999).
Bibliography:
"Salish." Britannica Online. <http://www.eb.com:180/cgi-bin/g?DocF=micro/520/47.html >
(15 February 1999).
Note: The date in parenthesis is the day you used the Web site.
Dissertation (Chicago Manual of Style, p. 587)
Note:
17. James M. Diehl, "Anthropology at War: World War I and the Science of Race in Germany" (Ph.D.
diss., Indiana University, 2002).
Bibliography:
Diehl, James M. "Anthropology at War: World War I and the Science of Race in Germany." Ph.D. diss.,
Indiana University, 2002.
Web Site
Note:
21. Hugh Elton, "Byzantine Warfare," Warfare in the Ancient World, 4 April 1999, (23 April 1999).
<http://shakti.trincoll.edu/~helton/army.html>.
Bibliography:
Elton, Hugh. "Byzantine Warfare." Warfare in the Ancient World. 4 April 1999.
<http://shakti.trincoll.edu/~helton/army.html> (23 April 1999).
Note: The first date is the day the Web site was created or last updated, the last date is the day you used
18
the Web site.
For Subsequent References to the Same Source:
When you cite the same work in a subsequent reference, use only the author’s last name and the page number.
In cases of two authors, use both last names. In case of more than two authors, use the first author’s last name
and the
abbreviation et al. for the remaining authors. In the case of an article or book without an author, use a shortened
title and page number.
1. Bordon, p. 17.
2. Jones and Smith, p. 91.
3. Somerset, et al., p.13.
4. Civil War, p. 42.
In addition, you may use the Latin abbreviation "Ibid." when citing subsequent sources that immediately follow
the first reference.
19
Using Good Grammar in Technical Writing
Sentence Construction
What is a sentence?
A sentence is a group of words which makes sense in itself. It must contain a subject, at least one complete
verb, and one main item of information (a complete thought) to which various subsidiary ideas may be added.
How do we compose sentences?
A sentence is composed of clauses and/or phrases.
SENTENCE
Clauses
Main/Independent
Phrases
Subordinate/
Dependent
A clause is a group of words that contains a subject (doer of the action) and a predicate (the action in the
sentence) and functions as part of a sentence. A main or independent clause must contain a subject and a
verb and express a complete thought. A subordinate or dependent clause does not mean anything on its own;
it depends on the main clause to give it meaning.
Examples:
Sentence:
Clauses:
The meeting
subject
started
predicate
at 4:00 p.m.
phrase (prepositional)
Although he tried to hurry, he was late for the meeting.
subordinate
main
A phrase is a group of related words that does not include a subject and verb.
Examples:
Prepositional phrases (start with a preposition): Within minutes…
Infinitive phrases (start with verb in infinitive form):To understand the programme, …
20
Participial phrases (contains verb participle): Its slopes collapsing, …
21
Sentence Structures
There are three common sentence structures: simple, compound and complex.
1
2
Simple:
 Contains 1 main clause.
 Expresses one main idea.
Compound:
 Contains 2 or more main
clauses.
 Expresses 2 or more ideas of
equal importance.
Possible sentence patterns:
 Main clauses (joined by
coordinating conjunctions – and,
but, for, or, nor, so, yet)

Main clauses joined by a semicolon.
Compound sentence possible
sentence patterns:
 Main clauses joined by a semicolon and a transitional word –
therefore, moreover, thus,
consequently, however, also.
3
Lava from a nonexplosive eruption ordinarily contains only
0.2 percent water.
Precursor activity to the eruption began on March 20, 1980,
and many times during the next two months the mountain
shook for minutes.
Precursor activity to the eruption began on March 20, 1980;
many times during the next two months the mountain shook
for minutes.
The initial cost of the machine is high; however,
maintenance is relatively inexpensive.
Complex
 Contains a main clause joined
with one or more subordinate
clauses.
 Expresses a main idea
supported by subsidiary
information.
Possible sentence patterns:
 Subordinate conjunction and
subordinate clause. followed by
main clause.
Although the amount of devastation caused by the May
18 blast was a surprise, the eruption itself had been
expected for weeks.
Main clause followed by
subordinate conjunction and
subordinate clause.
The eruption itself had been expected for weeks although
the amount of devastation caused by the May 18 blast
was a surprise.
Examples of subordinate
conjunctions/dependent markers
are because, before, since, while,
although, if, until, when, then,
Note: When the subordinate clause starts a sentence, a comma

is used before the main clause (See example 2 above). However,
if the main clause starts a sentence, no comma is necessary (See
example 1 above).
after, as, as if.
Punctuation
Punctuation Characteristics
Comma ( , )
Denotes a slight pause
Main Uses
Examples
1. After an introductory clause or
phrase.
Before leaving home, I switched
off the television.
Exception:
If the phrase is directly followed by a
verb, and not the subject, the comma
is omitted.
2. Before co-ordinating conjunctions
in a compound sentence (and, but,
or, nor, so, yet).
Out of the BMW stepped the
woman we were looking for.
Exceptions:
If clauses are very short and closely
connected, the comma may be
omitted.
Fran played the piano and John
sang.
If two verbs share one subject –
compound predicate – the comma is
omitted, unless ambiguity may arise.
The farmer and his faithful
workers harvested the July crops,
and their children helped them.
Promoters said the investment
was for a limited time and could
not be extended at all.
She recognized the man who
entered the room, and gasped.
(Comma used to prevent ambiguity).
3. After a transitional phrase that
links sentences or parts of
sentences.
4. Between all items in a series
(serial/series comma)
The rain fell yesterday. As a
result, we did not go to the beach.
I dedicate this thesis to my
parents, Mother Teresa, and the
Pope.
The meal consisted of soup,
salad, and macaroni and cheese.
5. Between adjectives if you can
substitute the word “and” for the
comma.
He wore a dirty, brown shirt.
6. To set off useful but non-essential
information.
Elise, my older sister, visited us
last Christmas.
23
Punctuation Characteristics
Main Uses
Examples
Commas ( , )
7. After a dependent clause that
precedes a main clause.
Although the laboratory was
closed for the week, the students
tried to gain access.
8. After a main clause that precedes
a dependent clause containing
supplementary but non essential
information.
She ought to be promoted, if you
want my opinion.
Exception:
If the dependent clause is restrictive,
i.e. contains information essential to
the sentence’s meaning, then the
comma should be omitted.
Paul was astonished when he
heard the news.
Note: The distinction is occasionally
tenuous. If in doubt, use the comma
to indicate a pause.
9. Before and after a non restrictive
relative clause, i.e., contains details
which if omitted do not affect the
meaning of the sentence.
Note: Relative clauses usually begin
with “who”, “which”, “that”, “when”,
and “where”
Restrictive relative clauses contain
information essential to the
sentence’s meaning. No commas
are used.
Semi colon
(;)
Denotes a pause stronger
than that of a comma but
weaker than a full stop
This book, which I finished
yesterday, is due back tomorrow.
She is the woman who arrived late.
The report that the students
submitted was well documented.
1. To join two closely related
independent clauses when there is
no connecting word (e.g. subordinate
conjunction or conjunctive adverb).
The idea is not to use the test to
get people in trouble; it is to help
them avoid decisions they will
regret later.
2. To join two independent clauses
when there is a subordinate
conjunction.
He was determined to complete
his degree; consequently, he
studied diligently.
24
Punctuation Characteristics
Main Uses
Semi colon
(;)
3. To separate items in a series
when one or more of the items
contains internal commas.
The students came from Mona,
Jamaica; St. Augustine, Trinidad;
and Cave Hill, Barbados.
1. After a complete thought that
introduces a list of items.
Words such as these, the following,
and as follows may introduce the list.
The recruiters were looking for the
following 3 qualities: initiative,
versatility, and enthusiasm.
2. To introduce long quotations.
The chief researcher said: “The
generator uses a small version of a
thermo-acoustic, sterling engine,
developed at Los Alamos in 1999.
That engine converts heat to
acoustic energy using no moving
parts.”
3. After business letter salutations:
Dear Ms. X:
1. To set off parenthical elements
containing internal commas.
The three top students – Andrew
Smith, Brent Cowie, and Charlene
Maxwell – won awards.
2. To separate an introductory list
from a summarizing statement.
Dell, IBM and Apple – these are
three of the leading computer
manufacturers.
3. To emphasise a sentence
interruption
Executives at IBM – despite many
rumours in the stock market –
remained quiet about dividend
earnings.
Colon ( : )
Dash or em
dash (–– )
Introduces an element or
series of elements
illustrating or amplifying
what has preceded the
colon
May perform a similar
function as commas,
parentheses, and colons.
Examples
Note: No sentence should
contain more than two em
dashes. Use parentheses
if more than two elements
need to be set off.
Other items
referred to
as dashes
- hyphen
– en dash
Hyphen is used in
compound words, names,
and word divisions
Dirty-brown
Chase-Caffyn
En dash connects numbers
and less often words
1920—1940
25
Punctuation Characteristics
Main Uses
Examples
Parenthesis
( )
To set off information that is less
closely related to the rest of the
sentence than that enclosed in em
dashes or commas.
He suspected that the inert gases
(helium, etc.) could produce a
similar effect.
Square
Brackets [ ]
To enclose material – usually added
by someone other than the original
writer – that does not belong to the
surrounding text.
The witness said, “They [the
police] brutalized the suspects in
custody.”
Curly
Brackets or
Braces { }
Angle
Brackets < >
Heavily used in
programming language,
mathematics, and other
specialized writing.
Encloses codes for the
typesetter in electronic
manuscript preparation.
Source: Chicago Manual of Style. 2003. 15th Edition. Chicago: Chicago University Press. Chapter 6.
26
Defining Grammar
Grammar can be defined according to the structure and usage of language.


It is the systematic description of the way words work together to form a coherent
language. (Structure)
It is the set of ‘rules’ that governs how a language ought to be spoken and written. (Usage)
Source: Brusaw, Charles T, Gerald J. Alred, and Walter E. Oliu. 1998. Handbook of Technical
Writing. 5th Ed. St. Martin’s Press.
Common Grammatical Errors
1. Poor sentence construction
i. Sentence Fragments
ii. Run on/ fused sentences; Comma splices
iii. Word choices including word context, jargon, colloquialism, idioms and clichés, slang, and
abbreviations.
2. Subject-verb agreement
3. Verb inconsistency
4. Unparallel structure
5. Ambiguous modifiers
i. Dangling modifiers
ii. Misplaced modifiers
iii. Squinting modifiers
6. Poor punctuation
7. Poor spelling and commonly confused words
27
Common Errors
1. Poor sentence
construction
Definition
Affects…
A sentence is a group of
words which makes sense
in itself. It must contain at
least one complete verb,
and one main item of
information to which various
subsidiary ideas may be
added.
A sentence that is too long
makes it difficult for the
reader to understand the
ideas expressed.
Clarity
Lava contains only 0.2
Coherence
percent water.
Conciseness
Fragment: The volcano’s
eruption had been expected
for weeks. Although the
amount of devastation caused
was a surprise.
Correction: The volcano’s
eruption had been expected
for weeks although the
amount of devastation caused
was a surprise.
Sentences are composed of
clauses and sometimes
phrases.
There are two types of
clauses:
Main/Independent and
Subordinate/Dependent .
i. Sentence
Fragments
ii Run on/fused
sentences
Comma Splices
A fragment is an incomplete
sentence.
“Run-on” and fused
sentences describe two or
more main clauses joined
together with no connecting
word or punctuation.
A comma splice, a type of
“run-on” sentence, is the
use of a comma between
two main clauses.
Examples
Clarity
Run on/Comma splice:
Mechanical engineers work in
many industries, their work
varies by industry and
function.
Correction: Mechanical
engineers work in many
industries, and their work
varies by industry and
function.
Common Errors
iii Word choices
including word
context,
colloquialism
jargon, , idioms
and clichés,
slang, and
abbreviations.
2. Subject-verb
agreement
Definition
Affects…
Examples
Word context – knowing
the meaning of words
used, paying attention to
position of words, and
repetition of “favourite”
words or phrases.
Colloquialism –
language used in familiar/
informal conversation.
Idioms/idiomatic
expressions –
expressions whose
meaning do not follow
from the meaning of the
individual words which
make up the expression.
Clichés – overused or
unoriginal words or
expressions.
Jargon – words or
expressions used by a
particular profession or
group that are difficult for
others to understand.
Slang – informal
language that is more
common in speech than
in writing.
Abbreviation –
shortened word, phrase
or text.
Circumlocution – the
use of too many words
where fewer would be
better.
A verb must agree with
its subject. A singular
subject has a singular
verb, and a plural subject
has a plural verb.
Concrete
Context
Conciseness
Clarity
Word meanings: E.g. Weight
vs. mass
Word position: Modifiers such
as “only”
Word repetition: Incidentally, in
fact, apparently
Colloquialism
Contractions: I’ll (I will); don’t (do
not)
Filler words: conversational
words used to enhance the flow
of spoken language – I mean,
right, Ok.
Idioms
Take on board – note
Break new ground – start
something new
Clarity
Disagreement: The accuracy
and applicability of the model
was tested.
Agreement: The accuracy and
applicability of the model were
tested.
29
Definition
Affects…
Examples
3. Verb
inconsistency
One tense must be
maintained for the main
discourse. Do not
move from one tense to
another if the time
frame for each action or
state is the same.
Clarity
The main tense is the present.
A dragonfly rests on a branch
overhanging a small stream this
July morning. It is newly emerged
from brown nymphal skin. As a
nymph, it crept over the rocks of
the stream bottom, feeding first on
protozoa and mites, then, as it
grew larger, on the young other
aquatic insects. Now as an adult,
it will feed on flying insects. Its
head, thorax, and abdomen glitter;
its wings are iridescent in the
sunlight.
4. Unparallel
structure
Parallel structure
means using the same
syntactical structure to
show that two or more
ideas have the same
level of importance.
Coherence
Unparallel: The report was written
quickly, accurately, and in a
detailed manner.
Parallel: The report was written in
a quick, accurate, and detailed
manner.
5. Ambiguous
modifiers
A modifier is a word,
phrase, or clause that
describes, clarifies, or
gives additional
information about other
elements in a sentence.
To avoid ambiguity,
modifiers should be
next to or close the
word they are
modifying.
A dangling modifier is a
word or phrase that
modifies a noun or
pronoun that is not
clearly stated in the
sentence.
Clarity
Common Errors
i
Dangling
Ambiguous: While eating dinner
at home, the computer
malfunctioned.
Clearer: While I was eating dinner
at home, the computer
malfunctioned.
30
Common Errors
ii
iii
Misplaced
Squinting
6.
Poor punctuation
7.
Poor spelling
Commonly
confused words
Definition
Affects…
Examples
A misplaced modifier
occurs when the word
modified is not clear or
could be more than
one word.
Clarity
Context
Observe the different meanings
of these 2 sentences:
A squinting modifier
occurs when there is
some ambiguity as to
which sentence
element the modifier
should describe.
Clarity
Incorrect use and no
use of commas, semi
colons, colons,
dashes, parentheses,
and brackets
Write or name the
letters that form a word
in an incorrect
sequence.
Clarity
Coherence
See the Chicago Manual of Style.
Clarity
Concrete
Coherence
The rule for –ie and –ei: receive,
relief
Words ending in –sede, -ceed,
and –cede.
To use words
inappropriately
especially when they
are similar sounding.
We almost lost all of our money.
We lost almost all of our money.
Which sentence element is being
modified?
We agreed on the next day to
make the changes.
It’s/its; advice/advise; cite, site,
sight; principal/principle
Check this URL for other
examples
http://www.io.com/~hcexres/tcm1
603/acchtml/twspell.html.
31
Bibliography
1. Alley, Michael. 1996. The Craft of Scientific Writing. 3rd edition. NY: Springer-Verlag.
2. Barass, Robert. 2002. Scientists Must Write. 2nd edition. Routledge: London and New York.
3. Brusaw, Charles T, Gerald J. Alred, and Walter E. Oliu. 1998. Handbook of Technical Writing.
5th Edition. NY: St. Martin’s Press.
4. Chicago Manual of Style. 2003. 15th Edition. Chicago: Chicago University Press.
5. Concise Oxford English Dictionary. 10th Edition revised. Oxford: Oxford University Press.
6. Guffey, Mary Ellen. 2003. Business Communication: Processes and Product. 4th Edition. Ohio:
Thomson South-Western.
7. Online Writing Lab. Available from http://owl.english.purdue.edu/. Accessed September 2004.
8. Online Technical Writing: Spelling Problems. Available from
http://www.io.com/~hcexres/tcm1603/acchtml/twspell.html/. Accessed September 15, 2005.
9. Review of Grammar and Usage. Available from
http://webtrain.austin.cc.tx.us/~technical1/tnrcc_gram_usag.html. Accessed September 14, 2005.
10. Wikipedia, the Free Encyclopedia. Available from http://en.wikipedia.org/. Accessed September
14, 2005.
11. Writing Guidelines for Engineering and Science students. Available from
http://www.writing.eng.vt.edu/. Accessed September 2004.
32
Technical Oral Presentations
Understand the context of your presentation
Analyze your audience
Understand and articulate your purpose clearly
Develop sufficient and appropriate supporting material
Organize the material so it is easy for the audience to follow
Choose a speaking style, level of language, approach to the subject, and tone suitable to
your role as well as your audience and purpose
Select graphics that will enhance your audience's understanding of your message
Understand the Context

What is the broader concern underlying the need for the presentation?

In what surroundings will you be making the presentation?

What will happen in the situation before and after your talk?
Audience Analysis

You must know how your audience will likely respond based on their
Educational and cultural background, knowledge of the subject.

What do they expect from me?

How interested will they be in what I say?
Plan the Presentation

What are the main questions they will want you to answer?

Which of these questions is most important? least important?

Based on your purpose and the audience's expectations, in what order should
you present these ideas?
Choosing Visual Aids

help your audience understand your ideas;
33

show relationships among ideas;

help the audience follow your arguments [your "train" of thought]; and

help your audience remember what you said.

Avoid too much information on any single visual.

Use boldface type in a font size that can be easily read.
TIPS
Checklist for Technical Presentations

Use sans serif type because if produces a sharper image for slides and
transparencies.

Limit the fonts you use to two per visual.

Avoid all caps.

Use a type--size and font--that contrasts distinctly with the background.

Avoid visuals that use too many colors--more than four on any one aid.

Avoid making your audience study your aids. If they are busy trying to decipher
your visual aid, they will not be listening to you.
Presentation Style

What kind of tone do I want to use in addressing my audience?

What kind of image of myself and my organization do I want to project?

What level of language do I need to use, based on my audience's background
and knowledge of my subject?

What approach will my audience expect from me? How formal should I be?
34
Use the following questions to ensure that your technical report is structured properly according
to our specifications:

Do you include all the required components in the required order, for example,
transmittal letter, followed by title page, followed by figure list, and so on?

Do you address your report to a real or realistic audience that has a genuine need for
your report? Do you identify in the introduction what background the audience needs
to read and understand your report?

Does your report contain specific, factual detail focused on the purpose of the report
and the needs of the audience and aimed at their level of understanding?

Does your report accomplish its purpose? Is that purpose clearly stated in the
introduction?

Does your report use information sources and do you properly document them?

Does your report use the format for headings?

Does your report use the format for lists?

Does your report use graphics and tables? Does your report use the format for
graphics and tables? Specifically, are your figure titles (captions) to specifications?

Does every new section (which starts with a first-level heading) start on a new page?
Have you check for widowed headings (headings that start at the very bottom of a
page)? Stacked headings (two or more consecutive headings without intervening
text)? Lone headings (a single heading within a section)? Parallelism in the phrasing
of headings?

Does the title page of your report include a descriptive abstract, and is it written
according to the specifications.

Do you include an informative abstract in your report; is it positioned properly in
relation to the other report components; and is it written according to the
specifications? Specifically, does your informative abstract summarize the key facts
35
and conclusions of your report rather than act as just another introduction or
descriptive abstract?

Does the introduction of your report include the elements necessary in good
introductions, such as audience, overview, and purpose? Do you avoid the problem of
having too much background in the introduction, or having an introduction that is all
background?
36
References
Texts
Kirkman, John. Good Style: Writing for Science and Technology. E & FN Spon, London.
1992
Neufeld, Jacqueline K. A Handbook for Technical Communication. Prentice-Hall, Incl, New
Jersey. 1986
Rutherfoord, Andrea J. Basic Communication Skills for Technology. Prentice-Hall, Incl, New
Jersey. 1991
Turk, Christopher and John Kirkman. Effective Writing: Improving Scientific, Technical and
Business Communication. E & FN Spon, London. 1982
Journals
West Indian Journal of Engineering. Volume 22. Number 1. July 1999
Websites:
This reference guide has been edited for this technical writing programme. The original and
unedited version of this manual is available online at:
http://134.117.206.17/www/resources/report_writing/pages/vidoli.htm
Other useful online references include:
http://134.117.206.17/www/resources/report_writing/pages/vidcover.htm
http://www.mech.ed.ac.uk/students/repstyle.html
http://www.io.com/~hcexres/tcm1603/acchtml/final.html
http://odtl.dcu.ie/wp/1999/odtl-1999-03.html
37
Download