Writing Instructions Guiding a reader through a process.
-
Upload
roxanne-phebe-wade -
Category
Documents
-
view
260 -
download
2
Transcript of Writing Instructions Guiding a reader through a process.
![Page 1: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/1.jpg)
Writing Instructions
Guiding a reader through a process
![Page 2: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/2.jpg)
Instructions must be usable and persuasive.
You have to persuade your reader to “use” the info.
Critical to making products, procedures, and systems safe and “user friendly”
![Page 3: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/3.jpg)
Analyzing Audience
Background (social, education)
Skill level Use appropriate vocabulary Translate necessary terms
Needs and use
An incorrect audience analysis is the biggest reason why instructions and manuals fail
![Page 4: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/4.jpg)
People read instructions in one of three ways:
1. All the way through, beginning to end
2. Others read and perform each step without looking ahead to the next
3. As needed
![Page 5: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/5.jpg)
Since you have no way to control the third group, assume you are writing for readers who will read and perform each step without looking ahead.
Therefore, for this assignment, all instructions must be in a strict chronological order
![Page 6: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/6.jpg)
Elements of Instructions (short version) General introduction
Step-by-step instructions
Conclusion
![Page 7: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/7.jpg)
Elements of Instructions(long version)
Everything that follows!
![Page 8: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/8.jpg)
Title
Use a specific title that accurately names the action covered in the instructions
Poor: Snow Removal
Better: Using Your Acme Snow Blower
“Using” is a participle that implies action
![Page 9: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/9.jpg)
Purpose
Explain the purpose of the instructions unless it is obvious (i.e., the purpose of a coffee maker)
Readers’ Questions
Will these instructions help me?
How can I use them effectively?
![Page 10: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/10.jpg)
Purpose & Audience
These instructions are for nurses who must inject dye into a vein through a balloon-tipped catheter.
This safe practices book is for employees who operate cranes and riggers.
![Page 11: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/11.jpg)
Writing Instructions (intro)
Reader-centered title Clearly stated purpose that includes reader
benefits List parts, materials, and conditions –this
includes a description of the actual tool or equipment your user is using Readers’ Question
Where are the parts that I’ll be working with while I repair or use this equipment?
What material and equipment should I collect before I begin?
![Page 12: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/12.jpg)
Parts, Materials & Conditions
If users need to gather items in order to follow the instructions, list those items in the introduction
– Materials - the items needed to perform the task (sandpaper, shellac)
– Tools - the implements needed (screwdriver, pliers, small paintbrush)
– Conditions - special circumstances that are important for completing the task successfully, such as using a dry, well-ventilated room
![Page 13: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/13.jpg)
Writing Instructions (steps)
Number (or otherwise organize) steps Use present tense and imperative mode Provide the right amount of info for each step Separate steps from background info or tips
![Page 14: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/14.jpg)
Be specific
Read a dial
![Page 15: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/15.jpg)
Be specific
Read the dial
![Page 16: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/16.jpg)
Be specific
Read the top dial
![Page 17: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/17.jpg)
Be specific
Read the top left dial (in red)
![Page 18: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/18.jpg)
What’s wrong with this?
1. Take out two slices of bread
2. Spread the peanut butter on the bread
3. I like mine with marshmallows and Fritos
4. The knife needs to be washed
5. Put the lid back on the peanut butter
![Page 19: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/19.jpg)
Is this better? Why?
1. Take out two slices of bread2. Take out a clean knife3. Take out the peanut butter
and jelly.4. Spread the peanut butter
and jelly on the bread5. Wash the knife and place
the lid back on the peanut butter
Note: I like to add marshmallows, and Fritos to my peanut butter sandwiches
![Page 20: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/20.jpg)
Writing Instructions (conclusion)
Tell readers what to expect after following the instructions and suggest other uses and options if appropriate
Your food will be hot, but not as brown as if heated in the oven rather than the microwave. A few minutes of standing time will complete the cooking cycle and distribute the heat uniformly
![Page 21: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/21.jpg)
Organization & Design
Separate your instructions into logical pieces (chronological order)
Use relevant instructions/graphics
Make the sections of your instructions visually distinct
Separate and label info that isn’t directly part of your instructions
![Page 22: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/22.jpg)
Writing Safety Information
Place in prominent area on the page (Location, location, location)
The more critical the safety comment, the LARGER and MORE EMPHATIC it should be
![Page 23: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/23.jpg)
Levels of Safety defined
Danger – likelihood of serious injury or death
Warning – potential for minor/moderate injury
Caution – potential for equipment damage
Note – suggestions for how to best carry out the task
![Page 24: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/24.jpg)
A note about safety info
There is no universal language or definitions for safety terms
Because of liability issues, companies will not (and should not) ask you to write safety instructions unless you’re a professional technical communicator
![Page 25: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/25.jpg)
Remember
Know your audience Keep your instructions simple Start with an introduction Use a clear and effective visual hierarchy DON’T SKIP STEPS JUST BECAUSE THEY
SEEM OBVIOUS Conclude with a summary or description And, one more time, just so we’re clear on
this…
![Page 26: Writing Instructions Guiding a reader through a process.](https://reader033.fdocuments.in/reader033/viewer/2022061616/56649f455503460f94c66e87/html5/thumbnails/26.jpg)
State the Obvious