Technical Writing Rhetoric Basics
Download
Report
Transcript Technical Writing Rhetoric Basics
Technical Writing
Rhetoric Basics
Dr. Brian Gastle
Western Carolina University
The Goals
Clear
No Ambiguity
Accurate
Precise and Correct Detail
Professional
Correct – Grammatically and Syntactically
Balance – Graphics, Text, Layout
Honest
Concise
Writing Issues
Verb Choice / Use
Modifier / Phrase / Clause Use
Sentence Length
Verb Choice / Use
Active vs Passive
Professional Verb Choice and “Vague” Verbs
Active vs Passive Voice
In Active Voice the subject is “doing” the verb
In Passive Voice, the subject of the sentence
is “being done” by the verb; acted upon
Form of “to be” plus the past participle
I blew up the office
The office was blown up
Active/Passive and tenses
Active
Teri embezzled money
Teri embezzles money
Teri will embezzle money
Passive
Money was embezzled
Money is embezzled
Money will be embezzled
Replace Verb to Change Voice
Sometimes you may want to replace the verb to switch voices,
or rewrite the sentence for clarity
State lotteries are used to fund education.
States use lotteries to fund education.
State lotteries support education.
She was called into the teacher’s office.
The teacher called her into her office .
(notice problematic pronoun ref)
The teacher summoned the student into the teacher’s office.
Passive vs Active Voice
Most of the information you need will be gathered as
you document the assembly process.
You will gather most of the information you need as
you document the assembly process.
Documenting the assembly process will provide most
of the necessary information.
When choosing multiple programs to record, be sure
that the proper tape speed has been chosen to
accommodate the length of all programs.
When recording multiple programs, choose a tape
speed that will accommodate the length of all
programs.
To Be Verbs
Try to use specific action verbs rather than forms of to be (similar
to ditching passive voice)
You can often use the noun following the “to be” as a
verb
He is the editor of two magazines.
He edits two magazines.
Major League Baseball was the first sports organization to institute
the concept of free agency for its players.
Major League Baseball became the first organization to
institute free agency for its players.
MLB instituted free agency before any other organization.
“Real” Subjects
There has been a decrease in the number of
students enrolled in our training sessions
The number of students enrolled in our
training sessions has decreased.
The use of in-store demonstrations has
resulted in a dramatic increase in business.
In-store demonstrations have increased
business dramatically.
Expletives and Nominalizations
Avoid Expletive Construction
“There are . . .” “There is . . .”
There are many service locations across the country.
Many service locations are located throughout the
country.
Avoid Nominalizations
Turning a verb into a noun
He made a change to the schedule
He changed the schedule
Nominalization – the “real” verb
Pollution constitutes a threat to the Wilson Wildlife
Preserve.
Pollution threatens the Wilson Wildlife Preserve.
Evaluation of the gumming tendency of the four tire
types will be accomplished by comparing the amount
of rubber that can be scraped from the tires.
We will evaluate the gumming tendency of the four
tire types by comparing the amount of rubber that can
be scraped from the tires.
Use of vague verbs
Examples
To be (is, was, be, etc.)
To do (did, done, etc.)
To make (made, will make, etc.)
To have (had, has, etc.)
Each of these materials has a unique
property.
Each of these materials possesses a unique
property.
Attendance policies are helpful to the
company in many ways.
Attendance policies help the company in
many ways
The product’s main focus is on reducing material
waste.
The product focuses on reducing material waste.
It is not the responsibility of this document to predict
all possible service problems
This document can not predict all possible service
events.
When someone gets a job, they have to know how to
maintain a schedule.
When someone acquires a job, he or she must know
how to maintain a schedule.
Proper lubrication is effective in preventing the
product from breaking.
Proper lubrication can prevent product malfunction.
Formal vs. Informal Language
The learning modules were put together by a couple of professors in
the department.
The learning modules were developed by two professors in the
department.
Two professors in the department developed the learning modules.
The biggest problem faced by multimedia designers is that users freak
if they don't see a button - or, heaven forbid, if they have to make up
their own buttons!
The greatest problems faced by multimedia designers is that users
become anxious if they fail to see a button or if they are required to
make their own buttons.
Two of the greatest problems faced by multimedia designers are that
users become anxious if:
1. users fail to see a button
2. users are required to make their own buttons
Sexist Language
Each doctor is asked to make sure he follows the standard procedure
for handling Medicare forms.
Each doctor is asked to make sure he or she follows the standard
procedure for handling Medicare forms.
All doctors are asked to make sure they follow the standard procedure
for handling Medicare forms.
All doctors should follow the standard procedure for handling Medicare
forms.
Policemen are required to live in the city in which they work.
Police officers are required to live in the city in which they work.
Police officers must live in the city in which they work.