Difference between revisions of "Instructions"
Line 9: | Line 9: | ||
==Guidelines for Instructions== | ==Guidelines for Instructions== | ||
The text covers several guidelines for writing good instructions. Here we will emphasize how each guideline can assist the reader and avoid frustration. | The text covers several guidelines for writing good instructions. Here we will emphasize how each guideline can assist the reader and avoid frustration. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
Line 110: | Line 63: | ||
===Guideline 12: Test Your Instructions=== | ===Guideline 12: Test Your Instructions=== | ||
Text! | Text! | ||
+ | |||
+ | |||
+ | ==Example Instructions== | ||
+ | Below are example instructions that employ nearly all of the guidelines. Below the instruction, we'll outline how each of the guidelines were effectively used, and demonstrate pitfalls of not using them. | ||
+ | |||
+ | |||
+ | These instructions detail the preparation of a Blizzard/McFlurry (or other similar ice cream or frozen yogurt treat) using given fast-food machinery, for the purpose of serving a customer. The presumed audience is someone completely new to the process of making this delicious item, who has no outside assistance at the moment. As such, the instructions need to be thorough, as well as easy to understand and follow. ''Note: These instructions assume the reader already has the required machinery and materials at hand.'' | ||
+ | |||
+ | |||
+ | <small> | ||
+ | '''Making a Blizzard''' | ||
+ | |||
+ | To make a Blizzard, follow the instructions below. Making a Blizzard involves first putting ice cream and toppings in a cup, and then blending them together using a blending machine. | ||
+ | |||
+ | |||
+ | '''Materials needed:''' | ||
+ | * Soft ice cream | ||
+ | * Toppings - Any other ingredients in a Blizzard. Could include crushed candy, strawberry sauce, etc. | ||
+ | * Cups | ||
+ | * Spoons | ||
+ | * Blending machine - Consists of a vertical rod that rotates to blend a Blizzard in a cup. The machine is controlled by a foot pedal - putting more pressure on the pedal will make the rod spin faster. | ||
+ | * Metal shield - A ring that fits on top of (and partially inside) a cup to stop ice cream from splashing out while blending. | ||
+ | |||
+ | |||
+ | '''Instructions:''' | ||
+ | : 1. Fit metal shield on to top of a fresh cup. | ||
+ | Filling the cup: | ||
+ | : 2. Fill cup half-way with ice cream. | ||
+ | : 3. Add toppings. | ||
+ | : 4. Fill cup to the top with ice cream. | ||
+ | :: ''Note: It is ok if the ice cream is filled above the cup's rim.'' | ||
+ | Blending: | ||
+ | : 5. Position cup underneath blender so that the rod is inside the ice cream. | ||
+ | :: '' '''Caution''': Always keep a firm grip on the cup while blending.'' | ||
+ | : 6. Simultaneously: | ||
+ | :* Gently push down blender pedal with your foot to start blending. | ||
+ | :* Slowly move cup up/down to mix the entire contents, keeping the foot pedal pressed down. | ||
+ | :: Continue until finished blending. | ||
+ | : 7. Lower cup so the rod is no longer in the ice cream, keeping pressure on the foot pedal. | ||
+ | :: ''Note: Do no lower the cup too much, or the rotating blending rod could spray above the metal shield.'' | ||
+ | : 8. Release foot from blender pedal. | ||
+ | Serving: | ||
+ | : 9. Remove metal shield from cup. | ||
+ | : 10. Get a spoon. | ||
+ | : 11. Serve. | ||
+ | Clean-up: | ||
+ | : 12. Rinse metal shield in water before next use. | ||
+ | </small> | ||
+ | |||
+ | |||
+ | ===Discussion of Guidelines Used in the Example=== |
Revision as of 16:40, 9 April 2008
Introduction
The intro text.
Contents
|
...by studentsdshjfhdskjfshd!
Guidelines for InstructionsThe text covers several guidelines for writing good instructions. Here we will emphasize how each guideline can assist the reader and avoid frustration.
Guideline 1: Select the Correct Technical LevelKnow your audience! You'll want to write your instructions in such a way that your least technical readers can understand them. Use language that all readers can understand, defining terms beforehand as needed.
Guideline 2: Provide Introductory InformationProviding proper introductory information is key. Instructions should follow the ABC format (Abstract/Body/Conclusion). An introduction should include:
Other introductory information that may help readers:
Guideline 3: Use Numbered Lists in the BodyInstructions are much easier to read as lists of steps, rather than longer paragraphs. Keep in mind that readers may frequently switch their attention between your instructions and the actual task. Using numbered lists, readers can always know what step they're at.
Guideline 4: Group Steps under Task HeadingsIt is a good idea to group steps into logical, labeled stages, rather than using one long list with no groupings. This will help the reader both follow and better understand the process.
Guideline 5: Place One Action in a StepFor exactly the same reasons that you shouldn't put several steps in a lengthy paragraph, you should also avoid putting multiple actions in one step. Unless two actions are to be done at the same time, each step should have no more than one action. Readers shouldn't have to read through lengthy steps to figure out which part of the step they're in.
Guideline 6: Lead off Each Action Step with a VerbStarting each step with a verb lets the reader immediately know what action is required in the step.
Guideline 7: Remove Extra Information from the StepText! Guideline 8: Use Bullets or Letters for EmphasisText! Guideline 9: Emphasize Cautions, Warnings, and DangersText! Guideline 10: Keep a Simple StyleText! Guideline 11: Use GraphicsText! Guideline 12: Test Your InstructionsText!
Example InstructionsBelow are example instructions that employ nearly all of the guidelines. Below the instruction, we'll outline how each of the guidelines were effectively used, and demonstrate pitfalls of not using them.
To make a Blizzard, follow the instructions below. Making a Blizzard involves first putting ice cream and toppings in a cup, and then blending them together using a blending machine.
Filling the cup:
Blending:
Serving:
Clean-up:
|