2. Instructions – Day 2

3. Parts of a procedure u Introduction Explain purpose Describe when applicable u Instruction steps Give steps, results, and required visuals u Optional section Troubleshooting or additional tips u NO conclusion

4. Chunk the text u Group the text into complete actions –Use headings to break the text up –Keep the user oriented u Chunks come from the task analysis u Think of hierarchy of actions

5. Software menu options u Standard convention for software menus is to hypenate the words when using multiple levels of menus. u Match menu spelling and wording

6. Examples of software menus u Example –Insert-Picture-From file –Tools-options u Poor examples –Click Header and Footer under the View menu –Click on Picture under the Insert menu, then From File.

7. Give results u Tell the user what the step will accomplish. How can they tell it has completed properly u Write in terms of Action/Result u Example Action: Set the CP-3 valve switch to OPEN. Result: The valve indicator light turns red.

8. Multiple levels of instructions u Use sub-steps to support various skill levels in the audience. u Make each major step a complete action. The sub-steps give the details to accomplish that action. u An experienced user can just read the step and other people can follow each sub-step.

9. Multiple levels of instructions

10. Supporting text u Requirements go up front, not with steps –Tool lists –When to accomplish the instructions –Prerequisites for the instructions u Step 7 is not the time to find out a special wrench is needed to remove the part.

11. Supporting text u What does pressing shift do? Does the user need to press shift?

12. Explanatory information u Provide explanations at the beginning u Include minimal explanations of why the steps are performed with the steps. u Any explanations must be obviously explanations, so users don’t think they are steps.

13. Word – Track changes ? Word can track all edits you make Word 2000 Word XP or 2003

14. Word – Track changes ? Use track changes for the instructions rewrite assignment due next time. ? Make your edits and email me a copy

15. Practice

21. End