simplicity and precision result from making good choices. to make good choices, you must go...

19

Upload: francine-waters

Post on 31-Dec-2015

215 views

Category:

Documents


1 download

TRANSCRIPT

Page 1: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process
Page 2: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Simplicity and precision result from making good choices.

To make good choices, you must go through a writing process.

A good writing process requires drafts, feedback, and revisions.

There are no shortcuts to good writing.

The Craft of Technical Writing (1)

Page 3: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

The Craft The Craft of Technical Writing (2)of Technical Writing (2)

Precise writing establishes your credibility as an engineer. Therefore…

Technical writing is a no-ambiguity zone: Ambiguity (defined as “doubtfulness or

uncertainty as regards interpretation) can often lead to serious misinterpretations.

Page 4: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Proposals and Reports Proposals and Reports in a Nutshellin a Nutshell

Reports communicate the purpose, methods, results, and conclusions of your experiments or research. In short, they spell out — —

what you did, what you did, how it was done,how it was done, what you discovered.what you discovered.

Proposals convince readers a plan of action is plausible and that the writer (or team) is qualified to accomplish it. In short, they spell out—

what you intend to do,

how you intend to do it,

what you hope to learn.

Page 5: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

How Paragraphs WorkHow Paragraphs Work

Effective paragraphs possess—

Unity: singleness of purpose Coherence: one point of view, one attitude,

one tense Focus: a strong topic sentence and supporting

evidence Flow: transitions from one sentence

to the next, from familiar to new information

Page 6: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Example of an EffectiveExample of an EffectiveParagraphParagraph

“The design of any device is fraught with failure. Indeed, the way engineers achieve success in their designs is by imagining how they might fail. If gases escaping from a booster rocket can lower efficiency or cause damage, then O-ring seals are added. If the friction of re-entry can melt a spacecraft, then a heat shield is devised.”

Petroski, H. (2003, August 29). Failure is always an option. New York Times. Retrieved September 11, 2003, from

http://www.nytimes.com

Page 7: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Ask Yourself These Ask Yourself These QuestionsQuestions

Is title specific and clear? Does the abstract prompt the reader’s

interest? Does the introduction clarify and forecast

your objectives? Does each paragraph include a topic

sentence that expresses a central idea? Are all other sentences in the paragraph

related the main topic? Is the level of formality (tone) appropriate

to your audience?

Page 8: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Criteria for Success:Criteria for Success:OverviewOverview

You facilitate decision-making, emphasize conclusions, use supporting data.

A broad audience can read and understand your report.

You clarify the problem, emphasize merits of the study, and show practical results.

Page 9: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Criteria for Success:Criteria for Success:Writing for Multiple AudiencesWriting for Multiple Audiences

You write a clear, concise, non-technical Abstract so that a top executive can review and act on the report.

Your Introduction and Background and Discussion and Conclusion sections give detail but remain clear, concise, and non-technical so that your immediate boss can understand your main points even if the boss is not an expert.

Professionals in your field will understand your Experimental Methods, Results, and Appendices.

Page 10: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Criteria for Success:Criteria for Success:Crediting SourcesCrediting Sources

You use quotation marks around authors’ original words or paraphrase the authors’ ideas in your own words.

You include citations for quotes or paraphrases of information borrowed from your sources.

You include references for your sources on a separate References page.

Page 11: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Ouch!Ouch!

—Your report is both good and original, but the part that is good is

not original, and the part that is original is not good.*

*Samuel Johnson, 1709-1784

Page 12: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Credibility and Depth of Credibility and Depth of Research—Striking the Right Research—Striking the Right

Balance Balance Cite enough sources so that your audience

trusts your conclusions and recommendations.

Don’t overload your reports with cited material at the expense of your own insights.

Page 13: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Does the Conclusion—Does the Conclusion—

Restate objectives of report? Assert the significance of your findings? Provide recommendations? Confirm or contradict an established

principle or theory? Answer the question, "So what?"

Page 14: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Summing Up Summing Up

Successful Technical Communicators—

Write to multiple audiences. Write unified and coherent paragraphs and

use strong subjects and verbs in sentences. Cite sources as needed and include a

reference page. Visit the Hanson Center.

Tell what you did, how you did it, and why you did it. Your audience wants both clarity and analysis.

Page 15: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

A Few Thoughts on A Few Thoughts on Technical Presentations (1)Technical Presentations (1)

Give yourself enough time to plan adequately.

Use an attention-getting introduction.

Clearly mark a road map to your presentation.

Use clear and well-organized explanations.

Page 16: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

A Few Thoughts on A Few Thoughts on Technical Presentations (2)Technical Presentations (2)

Conclude dramatically.

Use effective visual aids.

Practice an understandable delivery.

Always remind us of your credibility.

Page 17: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Create audience rapport.

Learn to handle questions.

Overcome nervousness.

Make an appointment at the Hanson Center.

A Few Thoughts on A Few Thoughts on Technical Presentations (3)Technical Presentations (3)

Page 18: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

HCTC Office HoursHCTC Office Hours

1:00 to 4:30 p.m., Monday through Friday

Sunday, 2:00 – 4:00 p.m.

Sign up sheet posted outside of room 2224 SC

(near the Engineering Library)

Page 19: Simplicity and precision result from making good choices.   To make good choices, you must go through a writing process.   A good writing process

Thank You