52
TECHNICAL WRITING September 27, 2013bb

TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Embed Size (px)

Citation preview

Page 1: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

TECHNICAL WRITINGSeptember 27, 2013bb

Page 2: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Today

- Brief introduction to e-mails

- Improving writing skills: avoiding “wordiness”

Page 3: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”
Page 4: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

E-Mail

One of the most common forms of workplace communication.

- Within organizations.

- Between organizations.

Page 5: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

E-Mail

Think of work e-mail as a polite, informative, and friendly conversation.

Page 6: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

E-Mail

Generally less formal than business letters and some memos.

However, e-mails are still professional documents.

Page 7: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Specific subject line

Opening: provides context and gets to the point

Provides necessary info clearly (i.e., explanations, instructions)

Is polite with requests

Ends politely

Provides sender’s contact info

Salutation

Page 8: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

WARNING

People tend to write “sloppy” e-mails.

- Unorganized. - Poorly written.

- Full of errors.

Don’t forget:

REVISE and EDIT!

E-mails are still professional documents

Page 11: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Taking out the trash

In the class that we are going to hold on this day, it is my plan that we, as a class, will look at an issue which is common in writing fairly often; I want to talk about and discuss the issue of ‘wordiness’.

Today, we will examine a common issue, wordiness.

Page 12: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Wordiness

Conciseness is important in both academic and business writing.

- Concise writing expresses ideas without unnecessary wordiness.

Wordiness:

- Increases the length of your work without adding meaning.

- Makes writing more difficult to understand.

Page 13: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Wordiness

Example 1:

The reason why Dave came to Success College was because it is inexpensive in price.

2 issues:

1. The words reason, why, and because all express the same idea.

2. Saying something is inexpensive includes the idea of price.

Page 14: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Wordiness

Example 1:

The reason why Dave came to Success College was because it is inexpensive in price.

Concisely:

Dave came to Success College because it is inexpensive.

Page 15: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Wordiness

Example 2:

Despite the fact that she was feeling ill, Ann came to the conclusion that she would go to work.

2 issues:

1. ‘Despite the fact that’ is just a long way of saying ‘despite’.

2. ‘Came to the conclusion that’ is a long way of saying decided.

Page 16: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Wordiness

Example 2:

Despite the fact that she was feeling ill, Ann came to the conclusion that she would go to work.

Concisely:

Despite feeling ill, Ann decided to go to work.

Page 17: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Wordiness

In my opinion, I think the study of Sociology is very fascinating.

- This sentence can be cut down to three words:

Sociology is fascinating.

Page 18: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

WordinessIn my opinion, I think the study of Sociology is very fascinating.

Sociology is fascinating.

- In my opinion and I think just repeat the same idea.

- Fascinating is clearly a judgment, so there is no need to include either ‘I think’ or ‘In my opinion’.

- Sociology includes the idea of studying it, so the study of is redundant.

- Fascinating can be defined as very interesting, so adding very is unnecessary.

Page 19: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Some simple examples

All of the following examples are wordy.

- Why is each wordy?

- How can each be written concisely?

Page 20: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

1. The stegosaurus was huge in size.

- The stegosaurus was huge.

2. Now she is at school. • - She is at school.

3. He was happy and joyful about the great gift. • - He was happy about the gift.

4. Because of the fact that he got a good grade on the midterm, Tim decided to take the night off. • - Because he got a good grade on the midterm, Tim took the night off.

5. In the summer season, many Vancouverites like to picnic in Stanley Park. • - In the summer, many Vancouverites like to picnic in Stanley Park.

6. On January 14, in the middle of winter, the weather was freezing cold. • - On January 14, the weather was freezing.

Page 21: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

7. I think smoking in public places should be banned. • - Smoking in public should be banned.

8. In order to get the true facts of the case, the lawyer interviewed 4 witnesses. • - To get the facts, the lawyer interviewed 4 witnesses.

9. Furthermore, Henry VIII also married six different women. • - Henry VIII also married six women.

10. Redundancy is defined as unnecessary repetition. • - Redundancy is unnecessary repetition.

11. New Westminster, which was British Columbia’s first capital city, is located on the shores of the Fraser River. • - New Westminster, British Columbia’s first capital city, is located along the

Fraser River.

12. The computer is sitting on top of the table. • - The computer is on the table.

Page 22: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Common Causes of Wordiness

W = wordy C = concise

Use of vague words which need explanation instead of precise words.

W: She talked to him in a loud angry voice.

C: She yelled at him.

W: The crime wave had some bad results that cost people a lot of money.

C: The crime wave had some costly results.

Page 23: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Common Causes of WordinessUse of long expressions instead of individual words

W: to come to the conclusion that

C: to decide

W: to put forward the idea that

C: to suggest

i.e., The president put forward the idea that the meeting be extended.

The president suggested that the meeting be extended.

Page 24: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Common Causes of Wordiness

Repetitive wording:

end result

past experience

share in common

small in size

= end

= past

= share

= small

Page 25: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Common Causes of Wordiness

Repetitive wording:

made a discovery

made an attempt

made an accusation

made an appearance

made a decision

= discovered

= attempted

= accused

= appeared

= decided

Page 26: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”
Page 27: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”
Page 28: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Common Causes of Wordiness

Repetitive wording, or words that provide excessive detail

W: Imagine a mental picture of someone engaged in the intellectual activity of learning the rules of playing chess.

C: Imagine someone attempting to learn the rules of chess.

Page 29: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Common Causes of Wordiness

Over-use of “it” and “there” as meaningless subjects

W: It was exciting to go to the New Year celebrations.

C: The New Year celebrations were exciting.

W: There were thirty-four people in the room who were waiting for the mayor.

C: Thirty-four people in the room were waiting for the mayor.

Page 30: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Common Causes of Wordiness

Over-use of “it” and “there” as meaningless subjects

“Empty Openers”

W: There is a prize in every box of Almond Flakes cereal.C: A prize is in every box of Almond Flakes cereal.

Page 31: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Common Causes of Wordiness

Over-use of relative clauses (starting with that, who, which)

W: The news, which was released yesterday, was devastating.

C: The news released yesterday was devastating.

W: The girl who was talented gave a concert.

C: The talented girl gave a concert.

Page 32: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Common Causes of Wordiness

Over-use of passive verbs

W: The criminal was caught by the police, and later the

criminal was convicted by the courts.

C: The police caught the criminal and the court convicted him.

passive

passive

active active

Page 33: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Side note: passive vs. active voice

In business writing, active sentences are generally preferred over passive sentences.

Page 34: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Side note: passive vs. active voice

In academic writing, active sentences are preferred over passive sentences.

Active voice:

- The subject performs the action expressed by the verb.

i.e., Andrew threw the hammer.

Page 35: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Side note: passive vs. active voice

In academic writing, active sentences are preferred over passive sentences.

Passive voice:

- The subject receives the action expressed by the verb.

i.e., The hammer was thrown by Andrew.

Page 36: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Side note: passive vs. active voice

In academic writing, active sentences are preferred over passive sentences.

- The active voice is:

- More concise

- More direct

- Easier to understand

Page 37: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Side note: passive vs. active voice

Examples:

It is believed by some critics that Psycho is Hitchcock’s greatest film.

Active:

Some critics believe that Psycho is Hitchcock’s greatest film.

Page 38: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Side note: passive vs. active voice

Examples:

The Old Man and the Sea was written by Ernest Hemmingway.

Active:

Ernest Hemmingway wrote The Old Man and the Sea.

Page 39: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Side note: passive vs. active voice

Exception:

If the agent – the one performing the action- is unknown, you can use the passive voice.

i.e., The walls had been defaced by grafitti.

The car was pushed over the cliff.

Page 40: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”
Page 41: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

1. Terry Fox is perhaps one of Canada’s greatest modern heroes because he did something amazing even though he lost his leg.

Page 42: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

2. Terry Fox was born in 1958 in Winnipeg, Manitoba.

Page 43: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

3. At the age of 19, Fox was diagnosed with a rare form of bone cancer.

Page 44: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

4. Doctors decided to amputate most of one of his legs to stop the cancer from spreading.

Page 45: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

5. While recovering from the amputation, Fox came up with the “Marathon of Hope”, which he hoped would help him make a lot of money for cancer research.

Page 46: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

6. He began his run in St. John’s, Newfoundland on April 12, 1980.

Page 47: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

7. He ran nearly 40km per day and had run 5373 km when he got to Thunder Bay, a small city in western Ontario.

Page 48: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

8. In Thunderbay, cancer was discovered in his lungs so he had to end his run there.

Page 49: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

9. Fox was an inspiration to millions of people with his great bravery and devotion to his cause.

Page 50: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

10. With his run, he encouraged Canadians to contribute almost $25 million for cancer research.

Page 51: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”
Page 52: TECHNICAL WRITING September 27, 2013bb. Today - Brief introduction to e-mails - Improving writing skills: avoiding “wordiness”

Reminder

Practice E-mail assignment is due Monday (11:59 p.m.).