How to Write Clear Instructions
How to Write Clear Instructions
If you're a teacher or technical writer, you probably have to write instructions every day. But for many other people, writing clear instructions can be difficult. You might skip a key step because you assume your readers will automatically do it, or you might confuse your readers by including too many actions in one step. To write clear instructions, first make sure you understand exactly how to complete the task. Follow your instructions literally to make sure they will accomplish the task.[1]
X
Research source
Steps

Understanding the Task

Gather the materials needed. When you're writing instructions, you must first be familiar with the task personally. Get all the tools and supplies you'll need and lay them out in roughly the order you'll need them. Write down everything needed. When you write your instructions, you may want to include a list of tools or materials that are necessary to complete the task.

Perform the task yourself. Even if you've successfully completed the task several times, it's still a good idea to walk yourself through it before you write your instructions, so you don't forget anything. If you're familiar with the task, you may be prone to taking short cuts, so make sure you don't skip any steps or omit any information your reader may not have.

Make a detailed outline. As you perform the task, take a moment to write down what you've done. This helps you keep the instructions in logical order. If you're doing the task as you write down the steps, you know exactly what needs to be done and when.

Define your audience. Instructions for the same task may be written in different ways depending on who will be reading and attempting to follow your instructions. You'll write differently for teenagers than you will for adults. Consider the reason as well. The instructions for kids working on a project will be different from the instructions for parents helping their kids with a project.

Draft a short introduction. The introduction tells your readers what your instructions will enable them to do and what the final outcome will be if they complete all instructions. Keep in mind that most people will skip the introduction, or at most skim it, so don't include vital information or key warnings in the introduction. If you included an important warning in the introduction, be sure to include it in your steps as well, in case someone skipped the introduction. For example, if you're explaining how to make a peanut butter and jelly sandwich, you could mention that peanut butter and jelly is a wholesome, simple option that kids love for lunch or an afternoon snack.

Writing Your Instructions

Divide the task into baby steps. Each step should have a single action, not several, so it's more clear what the person needs to do. If you have more than one or two sentences per step, it probably can be broken up into smaller, less complex steps. For example, instead of writing "Put the dog's collar around its neck and attach the leash," break it up into: "Fasten the dog's collar around its neck" and "Attach the leash to the collar." "Fasten the dog's collar around its neck" becomes the first step, and "Attach the leash to the collar" becomes the second.

Start each step with an action word. Every step you write should be actionable. Use verbs that show your readers exactly the action they must take to complete that step of the task. Word your instructions in terms of what someone must do, not what someone must think or know. For example, if you're writing dog-walking instructions, "Check the collar's fit" is more actionable than "Know the dog's collar size."

Follow a logical progression. Assume that your reader is going to jump right in and start working on the task as soon as they read the first step. Typically they aren't going to read your instructions through all the way to the end. If there's something your readers need to know to complete a step, include that information with the step itself. If there is any inherent danger in a particular step, include this warning with the step itself, not in your introduction or at the end of your instructions when it's too late. Include guides to let your reader know when they've performed the step correctly. For example, you say: "Your dog's collar fits properly if you can place two fingers between the back of the collar and your dog's neck."

Choose your words carefully. Use simple language that anyone can understand. In most cases you want to avoid any jargon or technical terms. If you must use a technical word, provide a short and simple definition. For example, if you're explaining how to file a legal brief, you may need to use technical legal terms. Place the plain-language definition first, then give the term used in the courts.

Use positive actions. Generally, it's better to tell your readers what they should do to complete the task, rather than what they shouldn't do. As someone reads instructions, they're in the mindset to complete the task. If you start telling them what not to do, they might get confused and do that thing anyway. For example, for dog-walking instructions, it's better to say "check the collar's fit" than "avoid using a collar that's too small."

Write in second person. The pronoun "you" allows you to address your reader directly and can avoid confusion. When you use the pronoun "you," the reader knows exactly what they must do to complete the task, and doesn't have to guess. For example, if you wrote "the lever should be pushed," you leave your reader wondering who should push the lever. "You must push the lever" or even "push the lever" leaves no doubt that this is something your reader must do.

Include alternatives. For some tasks, there will be more than one way to accomplish a step or group of steps. Provide the alternative along with the step so that the reader can choose how they want to complete the task. For example, if you're explaining how to make a peanut butter and jelly sandwich, you can add: "Substitute almond butter in case of peanut allergies."

Use graphics where helpful. You may have heard the phrase "a picture is worth a thousand words." When it comes to writing clear instructions, sometimes a picture or diagram will make a particular action more understandable for your reader. For more technical instructions, make sure the reader can clearly see what's going on in the picture, and the action isn't obscured by tools or hands.

Testing Your Instructions

Organize your instructions into parts. Some complicated tasks have more than one part. If you're writing instructions for a larger task that includes several smaller parts, separate them into separate sections. If you're numbering your instructions, restart the numbering with each section. The reader will feel a sense of accomplishment after finishing each part. You should still break your task into parts, even if it doesn't have any semi-independent parts. Too many steps can overwhelm your readers.

Try your instructions as written. If you can't follow your instructions as written, nobody else will be able to follow them either. Enlist friends to complete your instructions as well and let you know if they found anything confusing. You may have to test your instructions several times, particularly if they are lengthy or complex.

Edit your instructions carefully. Typos and grammatical errors can ruin otherwise clear writing, making your instructions hard to follow. Read through them backwards and forwards to make sure they're error-free. If you're not confident in your editing skills, get a friend to look over your instructions for you.

Include a list of tools or supplies needed. Particularly if a task requires specific tools or materials, a list can be helpful for your readers. Put the list towards the beginning of your instructions so your reader can gather materials before they begin the task. Think of this like a recipe in a cookbook. Recipes always provide a list of ingredients and cookware at the beginning, so you can gather all these things before you start making the dish.

Provide warnings where appropriate. After testing your instructions, you may realize that there are hidden dangers you didn't address when you first wrote your instructions. Alert your readers to these dangers so they can take precautions. For example, if you're writing instructions on how to boil water, you may want to include a warning that the pot will be too hot to touch even before the water starts boiling.

What's your reaction?

Comments

https://lamidix.com/assets/images/user-avatar-s.jpg

0 comment

Write the first comment for this!