Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions...
-
Upload
abel-daniels -
Category
Documents
-
view
229 -
download
0
Transcript of Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions...
![Page 1: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/1.jpg)
Technical CommunicationA Practical Approach
Chapter 8: Process Explanations and Instructions
William Sanborn Pfeiffer
Kaye Adkins
![Page 2: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/2.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.2
Process Explanations and Instructions
Process Explanations Versus Instructions Guidelines for Process Explanations Guidelines for Instructions
![Page 3: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/3.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.3
Process Explanations Versus Instructions
Process Explanations Provide information to help readers understand
what has been done, is being done, or will be done
Process Instructions Show readers how to perform the process
![Page 4: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/4.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.4
Process Explanations Versus Instructions
![Page 5: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/5.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.5
Guidelines for Process Explanations
Purposes Describing an experiment Explaining how a machine works Recording steps in developing a new product Describing what happened during a field test
![Page 6: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/6.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.6
Guidelines for Process Explanations
Know Your Purpose and Audience Follow the ABC Format Use an Objective Point of View Choose the Right Amount of Detail Use Flowcharts for Complex Processes
![Page 7: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/7.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.7
Guidelines for Process Explanations
Know Your Purpose and Audience Do you need to provide an overview or specific
details? Do readers understand the technical content or
are they general readers? Do readers have mixed technical backgrounds? Does the description supply supporting
information, or is it the main part of document?
![Page 8: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/8.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.8
Guidelines for Process Explanations
Follow the ABC Format Abstract
Purpose statement Overview or list of the main steps that follow List of equipment or materials used in the process
![Page 9: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/9.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.9
Guidelines for Process Explanations
Follow the ABC Format Body
Paragraphs List of steps
![Page 10: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/10.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.10
Guidelines for Process Explanations
![Page 11: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/11.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.11
Guidelines for Process Explanations
Follow the ABC Format Conclusion
Keeps the process from ending abruptly Helps the reader put the steps together into a
coherent whole Shows how the process fits into a larger context
![Page 12: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/12.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.12
Guidelines for Process Explanations
Use an Objective Point of View Explain a process rather than direct how it
is to be done
![Page 13: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/13.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.13
Guidelines for Process Explanations
Choose the Right Amount of Detail Subdivide information for easy reading
In paragraph format use Headings Subheadings
In list format use An outline arrangement of points and subpoints
Place related steps into groups
![Page 14: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/14.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.14
Guidelines for Process Explanations
Use Flowcharts for Complex Processes Supplement a paragraph or list description with
a flowchart
![Page 15: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/15.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.15
Guidelines for Process Explanations
![Page 16: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/16.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.16
Guidelines for Instructions
Select the Correct Technical Level Follow the ABC Format Use Numbered Lists in the Body Group Steps Under Task Headings Place One Action in a Step Lead Off Each Action Step with a Verb
![Page 17: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/17.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.17
Guidelines for Instructions
Remove Extra Information from the Step Use Bullets or Letters for Emphasis Emphasize Cautions, Warnings, and
Dangers Keep a Simple Style Use Graphics Usability Testing
![Page 18: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/18.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.18
Guidelines for Instructions
Select the Correct Technical Level Select a language that every reader can
understand Use techniques of definition and description
![Page 19: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/19.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.19
Guidelines for Instructions
Provide Introductory Information Follow the ABC Format
Abstract: purpose statement Body: summary of the main steps Conclusion: list or illustration
Consider the following additional items: Pointers Definitions Theories Notes, cautions, warnings, and dangers
![Page 20: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/20.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.20
Guidelines for Instructions
Use Numbered Lists in the Body Group Steps under Task Headings
They divide fragmented information into manageable “chunks”
They give reader a sense of accomplishment Place One Action in a Step
Break up complex steps into units
![Page 21: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/21.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.21
Guidelines for Instructions
Lead Off Each Action Step with a Verb Use the command form of a verb
Remove Extra Information from the Step Label with “Note” or “Result”
Use Bullets or Letters for Emphasis Save numbers for your steps
Use bullets for a few items Use letters for several items
![Page 22: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/22.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.22
Guidelines for Instructions
Emphasize Cautions, Warnings, and Dangers Caution
Possibility of damage to equipment or materials Warning
Possibility of injury to people Danger
Probability of injury or death to people
![Page 23: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/23.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.23
Guidelines for Instructions
Emphasize Cautions, Warnings, and Dangers Placement options
Place in a separate section right before the instructions begin
Place in the text of the instructions Place repeatedly throughout the instructions
![Page 24: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/24.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.24
Guidelines for Instructions
Keep a Simple Style Keep sentences short Use informal definitions Use short words Be specific
![Page 25: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/25.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.25
Guidelines for Instructions
Use Graphics Place an illustration next to every major step
when The instructions or equipment are complicated The audience may contain hurried readers
![Page 26: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/26.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.26
Guidelines for Instructions
Test Your Instructions Perform usability testing
Team up with another class member or colleague Give this person a draft of your instructions Observe this person following your instructions Revise your instructions
![Page 27: Technical Communication A Practical Approach Chapter 8: Process Explanations and Instructions William Sanborn Pfeiffer Kaye Adkins.](https://reader035.fdocuments.net/reader035/viewer/2022062217/5697bf761a28abf838c80f07/html5/thumbnails/27.jpg)
Technical Communication: A Practical Approach, Eighth EditionW. S. Pfeiffer and K. Adkins
Copyright © 2013, 2010, 2006 Pearson Education, Inc., All Rights Reserved.27
Guidelines for Instructions
Point-of-Use Instructions Pop-ups Help files Quick-start guides Posters and decals