Technical Communication A Practical Approach

243 downloads 3572 Views 99KB Size Report
Communication. William Sanborn Pfeiffer. Kaye Adkins. (presentation revised to fit ENGR 139 by Xiannong Meng). Process in Technical Communication.
Process in Technical Communication 

Technical Communication A Practical Approach Chapter 1: Process in Technical Communication

    

William Sanborn Pfeiffer Kaye Adkins



Defining Technical Communication Determining the Purpose Analyzing Your Readers Collecting Information Completing the Outline Writing Initial Drafts Revising Drafts

(presentation revised to fit ENGR 139 by Xiannong Meng) Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

Defining Technical Communication  

Features of Academic Writing Features of Technical Communication



Features of Academic Writing 

Purpose 

Your Knowledge of Topic



Audience 

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Defining Technical Communication 

Features of Academic Writing 

Criteria for Evaluation 



Statistical and Graphic Support 

Sometimes used to explain and persuade

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

5

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Less than the teacher in general The teacher

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

4

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Defining Technical Communication 

Features of Academic Writing 

Depth, logic, clarity, unity, and grammar

Demonstrate your knowledge of the topic Practice communication ((writing) g) skills





3

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Defining Technical Communication



Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

2

Examples   

Essays Exams Research Papers

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

6

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

1

Defining Technical Communication 

Defining Technical Communication

Features of Technical Communication 



Purpose 



Accomplish a task



Your Knowledge of Topic



Audience







7

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Features of Technical Communication Examples     

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

9





 

Technical Communication



ENGR 139: Technical Written and Oral Communication

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

8

Defining Technical Communication



© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Used to explain conditions and present alternative courses of action

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins



In-house correspondence Short reports p Long reports Proposals Websites

Clearly organized ideas that meet the needs of busy readers

Statistical and Graphic Support 

Variety of people with differing technical backgrounds

Defining Technical Communication



Criteria for Evaluation 

Greater than the reader

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins



Features of Technical Communication

Academic Writing

Plays a practical role on the job Completed by an informed writer to an uninformed reader Read by many readers

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

 

 

10

Displays your knowledge Completed by a student for a teacher or fellow students Practice writing skills Aims to satisfy one person, the teacher(?)

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Defining Technical Communication

Academic writing to prepare for professional work You may still know the subject less than the professor (or not) Practice writing in business environment Satisfy audience (pretend they are your boss or professional peers)

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

11

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

12

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

2

Determining the Purpose 

Question 1: Why am I writing this document?  



Analyzing Your Readers

Answer in one or two sentences Move to the beginning of your outline

 

Obstacles for Readers Ways to Understand Readers Types of Readers

Question 2: What response do I want from readers? 

Pinpoint what you want your audience to know, think, or feel

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

13

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Analyzing Your Readers





  



Readers Are Always Interrupted Readers Are Impatient Readers Lack Your Technical Knowledge Most Documents Have More Than One Reader

15

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Analyzing Your Readers 







  

Write Down What You Know About Your Reader Talk With Colleagues Who Have Written to the Same Readers Find Out Who Makes Decisions Remember That All Readers Prefer Simplicity

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins



Managers Experts Operators General Readers



Managers 

These readers expect…   

17

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Types of Readers



Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

16

Analyzing Your Readers

Types of Readers 

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Ways to Understand Readers



Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

14

Analyzing Your Readers

Obstacles for Readers 

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

background information definitions of technical terms lists and other format devices that highlight points clear statements about what should happen next

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

18

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

3

Analyzing Your Readers 

Analyzing Your Readers

Types of Readers 



Experts 



These readers expect…    

19

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Analyzing Your Readers

 

21

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Translate information into action Give advice to those who make decisions

Third-Level Audience: Receivers 

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Decision-Making Levels 



Decision-Makers Advisers Receivers

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins



Second-Level Second Level Audience: Advisers 

20

22

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Collecting Information

First-Level Audience: Decision-Makers 

clear table of contents easy-to-read listings for procedures or instructions definitions of technical terms clear statement of how document affects their jobs

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins



Decision-Making Levels







Analyzing Your Readers





definitions of technical terms frequent use of graphics like charts and photos clear distinction between facts and opinions

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins





These readers expect… 





General Readers - “Laypersons” 

These readers expect…

Analyzing Your Readers

Types of Readers 

Operators 

thorough explanations of technical details data placed in tables and figures references to outside sources used in writing the report clearly labeled appendices for supporting information

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins



Types of Readers

   

Decide What Kind of Information You Need Devise a Research Strategy Record Notes Carefully Acknowledge Your Sources Keep a Bibliography for Future Use

Receive information contained in document

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

23

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

24

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

4

Collecting Information

Completing an Outline    

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

25

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Completing an Outline

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

  

27

26

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Writing Initial Drafts 

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

Record Your Random Ideas Quickly Show Relationships Draft a Final Outline Consider Where to Use Graphics

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Schedule at Least a One-Hour Block of Drafting Time Do Not Stop to Edit B i with Begin ith the th Easiest E i t Section S ti Write Summaries Last

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

28

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

Revising Drafts     

Adjust Content Edit for Style Edit for Grammar Edit for Mechanics Review Layout and Graphics

Technical Communication: A Practical Approach, 7th Edition W.S. Pfeiffer and K. Adkins

29

© 2010 Pearson Higher Education, Upper Saddle River, NJ 07458. • All Rights Reserved.

5