Everything so far has been writing down what the group is. The last part is writing down how its jobs are done, for someone who has never done them. Instructions are easy to write badly, because you know every step and your eye fills in what the page leaves out. Write one action to a step, then hand the page to someone new and watch where they stop. Fix the page there.

Complaints, praise and instructions

Writing instructions someone else can follow

A set of steps written for someone who has not done the task before, tested on one such person, and fixed where they stopped.

Start here Essentials

Write the steps for someone who has not done the task before, then watch one such person follow them. If your piece is a request rather than a set of steps, the same idea (one reader who was not there) is the test in Cutting it down.

  1. Write who will follow this and what they already know. One line, above everything else (who follows it).
  2. Write the steps, one action each, in the order they happen. Start each with a verb (one action to a step).
  3. Put what they need and how long it takes above the steps. Then what done looks like, and who to call if it does not work (above and below the steps).
  4. Hand it to one person who has not done it before, watch without helping, and write down where they stopped. Fix each stop in the page (the test).

Minimum time: 90 minutes, including the test. Done when: one person who has not done the task before finished it from your page without asking you a question.

Written for someone new to the task Understand

Instructions are the one piece in Learn Persuasive Writing where the reader decides nothing. They do what the page says, in order, and the page fails at the first place they cannot tell what to do next. That makes instructions easy to test and hard to judge from your own chair: you know every step, so your eye supplies whatever the page leaves out.

Who follows it, and what they already know

Write one line before the steps that names the reader and their starting point: "For a new hire on their first opening shift. Assumes you have had the food safety walkthrough." That line is for you as much as for them. Read every step against it: would that person know what this word means, or where this thing is?

Preference Learn Persuasive Writing’s rule is to write for the newest possible reader (someone new to both the place and the task) even when you expect a coworker who knows the building. A page that works for the newest person works for the people above them. The reverse rarely holds.

One action to a step, in the order it happens

Digital.gov's plain-language guide says to present process information as steps in chronological order. Convention That is federal guidance, not a finding from a study.

A step is one action the reader can finish and then look up from. "Check the oven and load the trays" is two steps if the oven might not be ready, because the second waits on the first. "Check that oven 2 reads 375 degrees and its ready light is green" is one step, because the reader does both in one glance. The test of a step is whether there is a pause inside it. If there is, split it there.

Three habits carry most of the rest.

  • Start each step with a verb. The imperative is the form of a verb that tells someone to do something: turn, wash, pull, sign. Preference No source on our list states this for instructions; it is Learn Persuasive Writing’s rule, and it follows from the active voice Digital.gov asks for.
  • Call the same thing by the same word every time. Digital.gov's "Short and simple" page says "You don't need to use synonyms to make your writing more interesting." Convention In instructions a synonym does worse than bore the reader: "the proofer" in one step and "the proof box" in the next reads as two machines. Use the word on the thing's own label, on every line.
  • Put the number in the step, with its unit, and say what the reader will see. "Reads 375 degrees", not "is hot". "The ready light is green", not "it's ready". Where the reader can check a result, name what they will see.

Most weak steps fail in one of a few ways.

As first writtenWhat is wrong with itRewritten
Get the oven going and get the first rack in.Two actions with a wait between them; "going" is not a setting; and lighting the oven is not this reader's jobCheck that oven 2 reads 375 degrees and its ready light is green. (A later step:) Load rack A.
Wash up.Says neither where nor howWash your hands at the sink by the line door.
The proofer should be checked.No verb the reader performs; "checked" for what?Check that the proof box display matches the number on the card taped to its door.
Do the usual opening checks.Assumes the reader knows the usualList each check as its own step, or name the posted checklist and where it hangs.

What goes above the steps, and what goes below

The steps are the middle of the page. Three things go above them and two below, and instructions often fail in these five lines rather than in the steps.

Above the steps:

  1. What it is for and who it is for. A title that names the task, and the one line about the reader.
  2. What they need. Tools, keys, materials, the badge, the mitts. A reader who finds out halfway through that they need a key from the office has to leave the task half done. On a posted page, say where a code is kept rather than printing it.
  3. How long it takes, and when it has to be finished. "About 45 minutes. Rack A goes in by 5:45 a.m." The reader uses this to tell whether they are behind.

Below the steps:

  1. What done looks like. A state the reader can check: the oven baking, the timer running, the log signed.
  2. What to do when it does not work. Who to call, how to reach them, and what to leave alone while waiting.

Digital.gov's "Organize the information" page puts the reason in one line: "Put the most important information at the beginning." Convention For instructions, the most important information is whether the reader can start: what they need and how long they have. That is why it sits above the steps and not in a note at the foot of the page.

Digital.gov's "Clear and short" page asks for one idea to a sentence. Preference Our own rule for instructions is one sentence to a step, two at most: the action, then what the reader sees when it is done. A step that needs a paragraph is usually two or three steps.

Where a warning goes

A warning, in a set of instructions, is a sentence about something that can hurt the reader, damage something, or spoil the work if the next action goes wrong. A warning goes before the step it warns about. Convention The reason is the plain-language rule Learn Persuasive Writing rests on: put the thing that matters first, so it is read before the action rather than after it. A reader follows instructions by doing each step as they reach it. A warning placed after the step, or gathered into a box at the foot of the page, reaches them after their hands have already done the thing.

  • Directly above its step, not at the top of the page. Ten cautions at the top are read once, at the start, and are not in front of the reader when it matters.
  • With what to do, not only what to fear. "The oven door is hot once the light is on. Use the long mitts on the hook." The second sentence is the one the reader acts on.
  • Only on the steps that need one. Preference If every step carries a caution, our reading is that people learn to skip them.

Two published standards govern safety messages and instructions for products. The first is ANSI Z535.6-2023. The American National Standards Institute's blog describes it as setting "requirements for the design and location of product safety messages" in the manuals, user guides and other printed material that come with a product. The second is IEC/IEEE 82079-1:2019, which its publisher's webstore describes as covering "all types of instructions for use", for products "ranging from a tin of paint to large or highly complex products". Both are sold, and we have read only those descriptions. We cite them for what they cover, for a product a business makes and sells, and not for what they require. The warning-before-the-step rule above stands as a convention on its own reason, not as something either standard says.

Limits

Instructions for work that can hurt someone or burn the house down are not Learn Persuasive Writing’s business. For electrical, gas, structural, roof, medication and medical tasks, write the name of the trade or the professional instead of a step list: an electrician, a gas utility or a plumber, a roofer, a pharmacist, the doctor or nurse who gave the order. For anything that came with a maker's manual (an oven, a furnace, a car seat, a power tool), the maker's manual is the instructions, and your page says where it is kept. At work, your employer's posted procedures and safety rules come first. Ask the authority Whoever your employer names for safety answers questions about them.

The test is the point

Everything above makes a page more likely to work. Only the test shows whether it does. You know where the sink is, so "the sink" looks clear to you. The test borrows a stranger's eyes.

Preference Learn Persuasive Writing’s minimum is one person new to the task, following your page once while you watch. It is smaller than the tests the federal guidance describes (under Go deeper, below), and it is one a person writing for one new hire or one house sitter can run this week. One person will not find every problem. They find the ones they meet, which is more than you find alone.

  1. Pick someone who has not done this task before. Not someone who has watched you do it; they will follow their memory instead of the page.
  2. Give them the page and nothing else. Say that you are testing the page, not them, and ask them to follow it as written. Then stop talking.
  3. Watch, and do not help. When they pause, ask a question, or do something the page did not say, write it down: which step, and what they did. Each of those is a stop. Digital.gov's paraphrase-testing page tells testers "Do not correct the participant." The same discipline applies here: a correction given out loud is a fix that does not reach the page.
  4. Step in if anything is unsafe. Watching without helping does not mean watching someone get burned. Stop the test, deal with it, and record it as the first stop to fix. Preference
  5. Fix each stop in the page. Then, if you can, give the fixed page to a second person.

Where a person stopped usually tells you what to change. Preference The table is our reading of common stops, not a published list.

What the person didWhat it usually meansThe fix
Asked "which one?"The page names a thing there is more than one ofName it by its place or its label; add a picture
Did a later step firstThe page's order is not the work's order, or a step is hidden inside anotherSplit the step, or move it
Read ahead, then came backThe step does not say what done looks like, so they could not tell when to move onAdd what they will see when it is done
Asked what a word meansJargon, or one thing called by two namesUse the word on the label, on every line
Missed a warningIt was below the step, at the foot of the page, or one of too manyMove it directly above its step; cut the ones that name no real risk
Finished, but lateThe time on the page was wrong, or a wait was not mentionedFix the time; make the wait its own step

Keep the steps and the stops in Instructions and test runs. Its first sheet holds one action to a row, with columns for what done looks like and for the warning that belongs before the step. Its second is the test log: who followed it, where they stopped, and what you changed.

Testing it the formal way, and keeping it current Go deeper

What the federal guidance says about testing

Digital.gov's "Test for understanding" page, part of the federal plain-language guide series, names three methods: paraphrase testing, usability testing and controlled comparative studies. It says "Plan to test at least twice": test, make corrections based on what you learned, and test again. Two of its pages give numbers.

MethodWhat the person doesHow many peopleHow longSource
Usability testingUses the document to do what it is for, usually thinking aloud"three to five people"A session "lasts about one hour"Digital.gov, Usability testing
Paraphrase testingExplains each section "in their own words"6 to 9 participantsNo session length given; the page says it will not take a lot of timeDigital.gov, Paraphrase testing
Learn Persuasive Writing’s minimumFollows the page while you watchOne person new to the taskThe length of the task, plus about ten minutes to write down the stopsLearn Persuasive Writing’s own rule

Usability testing is watching people use a document to do the thing it is for; thinking aloud means the person says what they are doing and why as they go. Paraphrase testing asks each person to explain a section in their own words, and the tester writes the notes in those words without correcting.

Preference We use paraphrase testing for letters, where the reader has to understand something (its one-reader version is the read-back test in Cutting it down), and usability testing for instructions, where the reader has to do something. Digital.gov does not divide them that way; it is our choice of tool for the job.

If many people will follow your instructions (a whole crew, every new hire for years), the federal numbers are worth meeting: three to five people, and a second round after the fixes.

Versions, dates and pictures

  • Date the page and say who keeps it. A posted page outlives the process it describes. A date lets the next reader tell whether it is current, and a name tells them who to tell when it is not. Preference
  • Replace the page rather than marking it up. A handwritten correction is read by some people and missed by others.
  • Use a picture where a sentence has to describe a place. A photo of the sink with an arrow works the first time. Learn Basic Graphic Design covers when a drawing does a sentence's job in Drawing to explain.

Oregon State University's Technical Writing Certificate, read for comparison on November 13, 2026, listed $2,495 plus a $70 registration fee for "160 hours of instruction". Its first class is "Manuals: Instructions and Overviews"; the rest cover usability, procedures and flowcharts, single-sourcing and a portfolio, which are occupational and cut here. What carries over to a page for one new hire is the test. The price is reference only; Learn Persuasive Writing sells nothing.

See it: the opening shift at Valley Hearth Bakery See it

Fictional example

Marisol Chen is a shift supervisor at Valley Hearth Bakery, a plant bakery in Fresno, California. A new hire starts on the opening shift, 5:00 a.m. to 1:30 p.m. Marisol works the closing shift, so she will not be there. She writes the opening as a page the new hire can follow alone. (Her own written request to move to openings is in Asking for something.)

Known. The tasks, in order: badge in and clock in, hairnet and handwashing, the oven 2 check, the proof box check, rack A to the oven, the opening log signed. Marisol walked the opening with Ruben Soto, who works it now, and wrote down each action as he did it. Lighting the gas ovens is not on the list: the maintenance lead lights them before the shift, under the procedure posted beside them.

Assumed. That the new hire has had the bakery's food safety walkthrough before the first shift. Marisol's assumption; she settles it by asking her manager, Dolores Ibarra, who schedules the walkthrough.

Open. What a new hire should do if oven 2 is not hot or shows a code. Settled by: the maintenance lead and the oven's posted procedure, not by Marisol. Her page names who to call and points to the procedure. Also open: whether the hairnet and handwashing lines match the bakery's written food safety plan. Settled by: whoever the bakery names as its food safety lead, whom Marisol asks.

Her first draft, written in five minutes on the back of a schedule:

Opening Badge in, clock in. Hairnet and wash up. Get oven 2 going at 375 and check the proofer. When the oven's ready get the first rack in. Check the proof box again. Sign the log. Careful, door gets hot.

Every word is true to how Ruben works, and he could follow it with his eyes shut. A new hire could not. "Wash up" does not say where. "Get oven 2 going" reads as an instruction to light a gas oven, which is the maintenance lead's job, not the new hire's. "The proofer" and "the proof box" are one machine under two names. "Ready" is not something a person can see. And the warning about the door comes after the step that opens it.

Her second draft, written with the steps sheet open, fixed most of that. At the start of her own shift, with the ovens already running for the afternoon bake, a packer from the afternoon line who had not worked an opening followed it while Marisol watched and did not help. The packer stopped twice. At the handwashing step she asked which sink, then used the one in the break room, because the page said "the hand sink" and there are two. At the proof box step she went looking for a second machine, because one line still said "proofer". Marisol logged both stops, fixed them, and added a photo of the sink. On the new hire's first opening, Ruben watched her follow the fixed page without helping, and she did not stop.

Opening shift: oven 2 and the first rack Revised November 12, 2026. Kept by Marisol Chen, shift supervisor.A date and a keeper. For a new hire on their first opening. Assumes you have had the food safety walkthrough.The reader and their starting point. You need: your badge; a hairnet, and a beard net if you have facial hair; the long oven mitts on the hook by oven 2. Time: about 45 minutes. The shift starts at 5:00 a.m. Rack A goes in by 5:45 a.m.What they need and how long, above the steps. 1. Badge in at the side door and clock in at the terminal by the break room. The terminal shows your name and the time. 2. Put on a hairnet, then a beard net if you have facial hair. Then wash your hands at the sink by the line door (photo below).The first test fix. The second draft said "the hand sink", and there are two. 3. Check that oven 2's display reads 375 degrees and its ready light is green. Do not use its controls: the maintenance lead lights and heats the ovens before the shift.A check, not a lighting step. Lighting a gas oven is not in these instructions. 4. Check that the proof box display matches the number on the card taped to its door. If it does not match, tell the shift lead."Proof box" on every line: the second test fix. 5. Roll rack A from the proof box to oven 2. Oven 2's door is hot. Put on the long mitts from the hook before you open it.The warning, directly above the step that opens the door, with what to do. 6. Open the door with the mitts on and load rack A. Close the door and press START on the timer. 7. Sign the opening log on the clipboard by oven 2, with the time rack A went in. Done when: oven 2 is baking rack A, the timer is running, and the log shows your name and the time. If oven 2's light is not green by 5:30 a.m., or its panel shows a code: leave the oven alone, call the maintenance lead on radio channel 2, and tell the shift lead. The oven's procedure is posted beside it.When it does not work: a person, a way to reach them, and the oven's own procedure rather than a repair list.
  • Organize the information: Digital.gov's page on putting the most important information first and presenting a process in the order it happens. Short, free, and the basis of the step order above.
  • Usability testing: Digital.gov's page on watching people use a document, the source of the three-to-five-people and one-hour figures.
  • Short and simple: the same series on cutting words, including its line against using synonyms for variety.

Practice: write it, then watch one person use it Practice

Minimum: one page of steps for a task you do, and one person new to the task following the page once while you watch. Time: about 90 minutes: 45 to write, the length of the task to test, and 15 to fix. Materials: the task itself, the steps sheet in Instructions and test runs or a sheet of paper, a pen for the stops, and one willing person.

  1. Do the task once yourself and write down every action as you do it. Not from memory. Memory skips the actions you do without thinking, which are the ones a new person needs most.
  2. Turn the list into steps. One action each, a verb first, the number and unit in the step, and what the reader will see when it is done. The steps sheet has a column for each.
  3. Write the lines above and below the steps. Who it is for and what they know, what they need, how long it takes, what done looks like, and who to call.
  4. Find every warning and move it directly above its step. Give each one an action. Cut any that name no real risk.
  5. Run the test. One person new to the task, the page, no help. Write each stop in the test log.
  6. Fix the page, date it, and replace the old copy.
Go deeper

A second round. Give the fixed page to a second first-timer. If they stop somewhere new, the first fix may have moved the problem rather than solved it.

Think aloud. Ask your tester to say what they are doing and why as they go. You hear the hesitation before the stop, which tells you which word caused it.

What you are writing What you are writing

Check your work Check your work

Criteria

  • Does a line above the steps say who the page is for and what they already know?
  • Is each step one action, starting with a verb, in the order the work happens?
  • Is each thing called by one word, the same word on every line?
  • Does every warning sit directly above its step, with an action the reader can take?
  • Are what they need and how long it takes above the steps, and what done looks like and who to call below?
  • Did one person new to the task follow it, and is every place they stopped fixed in the page?
  • For electrical, gas, structural, roof, medication or medical work, or a machine with a maker's manual, does the page name the trade, the professional or the manual instead of giving steps?

Worked example

Marisol's final page names its reader in its third line. Its seven steps each carry one action and start with a verb, and the checkable ones say what the reader will see. The proof box has one name. The warning sits directly above the step that opens the oven door, with an action. What a new hire needs and how long they have come first; what done looks like and who to call come last. Lighting the gas oven is not on the page, and a fault sends the reader to the maintenance lead and the oven's posted procedure rather than to repair steps. Both stops from the test are fixed, and the new hire then followed the fixed page without stopping. It passes every line.

Common mistakes

  • Writing it from memory. The steps you do without thinking are the ones that go missing. Do the task once with the page in your hand.
  • Testing on someone who has watched you do it. They follow what they remember, and the page's gaps stay hidden.
  • Helping during the test. Each answer you give out loud fixes the reader, not the page. Write the stop down instead.
  • Putting warnings at the bottom, or on every step. At the bottom they arrive too late; on every step they stop being read.
  • Two names for one thing. Read the page once looking only at nouns, and circle anything with two names.
  • A step list for hazardous work. Electrical, gas, structural, roof, medication and medical tasks get the name of the trade or the professional, and a machine gets its maker's manual.

What is still unresolved

This page does not settle whether the procedure itself is right: the oven temperature, the food safety rules, the order the plant needs. Those belong to the employer and, for equipment, to the maker's manual, and the person to ask is whoever the employer names. It does not cover a drawing in detail; Learn Basic Graphic Design's Drawing to explain does. For the instructions shape set out as a finished, annotated page beside the five other kinds, see Six letters, annotated. For cutting a page that has grown too long, and for the one-reader test applied to a letter, see Cutting it down.

Knowledge check and scenario

Why does a warning go above the step it warns about rather than at the foot of the page?
Because a reader does each step as they reach it, so a warning below the step, or in a box at the end, is read after the action. Putting it first is the plain-language rule of putting the thing that matters first. We state it as a convention on that reason; the product standards on safety messages exist, but we have read only their descriptions and do not cite them for what they require.
Halfway through your test, the person following your page asks, "Which cooler?" What do you do?
Write it down as a stop, at that step. If they cannot go on, answer the minimum and mark that you did. Then fix the page so it names the cooler by its label or its place, or shows a picture. An answer given out loud fixes this reader, not the page.
A friend asks you to write the steps for swapping a hallway light fixture so they can do it while you are away. What goes on the page?
Not a step list. Electrical work gets the name of the trade (an electrician) instead, and if the fixture came with the maker's instructions, the page says where they are. You can still write the parts that are not the hazardous work: where the fixture is, who is coming, and when.
(Go deeper) Digital.gov's usability testing page says to find three to five people. Why does Learn Persuasive Writing ask for one?
Because most everyday instructions go to one person, and one first-timer is a test you can run this week. For a page many people will follow, the federal numbers are worth meeting, along with Digital.gov's advice to test at least twice.
You are going away for a week. A neighbor who has been in your apartment once will feed the cat and water the plants. You have written a one-page set of instructions. You have two days before you leave.
"Does it make sense?" invites a polite yes, and Digital.gov's paraphrase-testing page says to avoid yes-or-no questions. You learn nothing about whether they can find the cat food.
This is the test the page needs. The neighbor meets the real cupboard and the real tap, and every stop is a line you can fix before you leave. It does not tell you how the cat will behave on day four.
A reasonable second best, close to Digital.gov's paraphrase test. It shows whether they understood the page, not whether they can find things in your apartment from it.

Checklist

Records your learning only; it is not a qualification.

The chapters in this book are also published at Learn Event Planning, Learn Digital Security, Learn Everyday Speaking, Learn Conflict Management and Learn Persuasive Writing, where the tools and record sheets they mention are kept.