7.4 Instructional Messages

Effective organization and style are critical in requests for action that contain detailed instructions. Whether you’re explaining how to operate equipment, apply for funding, renew a membership, or submit a payment, the recipient’s success depends on the quality of the instruction. Vagueness and a lack of detail can result in confusion, mistakes, and requests for clarification. Too much detail can result in frustration, skimming, and possibly missing key information. Profiling the audience and gauging their level of knowledge is key to providing the appropriate level of detail for the desired results.

Look at any assembly manual and you’ll see that the quality of its readability depends on the instructions being organized in a numbered list of parallel imperative sentences. As opposed to the indicative sentences that have a grammatical subject and predicate (like most sentences you see here), imperative sentences drop the subject (the doer of the action, which is assumed to be the reader in the case of instructions). This omission leaves just the predicate, which means that the sentence starts with a verb. In Figure 8.3 below, for instance, the reader can easily follow the directions by seeing each of the six main steps open with a simple verb describing a common computer operation: Copy, Open, Type, Paste (twice), and Find.

If you begin any imperative sentence with a prepositional (or other) phrase to establish some context for the action first (such as this imperative sentence does), move the adverb after the verb and the phrase to the end of the sentence. (If the previous sentence followed its own advice, it would look like this: Move the adverb after the verb and the phrase to the end of the imperative sentence if you begin it with a prepositional (or other) phrase to establish some context for the action first.) Finally, surround the list with a proper introduction and closing as shown in Activity 7.3 below.

^{Activity 7.3 | Instructional Message}

Though helpful on its own, the above message would be much improved if it included illustrative screenshots at each step. Making a short video of the procedure, posting it to YouTube, and adding the link to the message would be even more effective.

Combining DOs and DON’Ts is an effective way to help your audience complete the instructed task without making common rookie mistakes. Always begin with the DOs after explaining the benefits or rewards of following a procedure, not with threats and heavy-handed DON’Ts. You can certainly follow up with helpful DON’Ts and consequences if necessary, but phrased in courteous language, such as “For your safety, please avoid operating the machinery when not 100% alert or you may risk dismemberment.”