Monday, October 22, 2007

Writing Instructions

Procedures are a set of instructions. Instructions are a set of steps for doing a specific activity.

· Use numbers when steps must be taken in order; otherwise, use bullets.
· Use imperative sentences for action steps.
· Write one action per step.
· Identify main steps and provide detail in sub-steps.
· Identify the person who will perform the step if other than the reader.
· Start conditional steps with “If” or “When.”
· Use bold and/or all caps for conditional steps that are critical or safety issues.
· Limit branching, cross-references, or hyperlinks to action steps.
· Test the steps with end users.