Turn a known task into a route another person can complete
Step-by-step instructions are a small act of design. The writer must define the outcome, identify the user’s starting point, prepare materials and permissions, sequence one observable action at a time, place warnings before danger, show branches and recovery paths, and test the route with someone who did not invent it. English matters because a missing object, condition, unit or stop point can turn a familiar task into confusion. Clear instructions transfer reliable action without pretending that every situation is routine.
Choose the route closest to your task, or read straight through for the complete system.
People search for how to write step-by-step instructions because knowing how to perform a task is different from making that knowledge usable by somebody else. Students explain a laboratory setup, club members document an event routine, families share device steps, and workplaces record processes that should survive a handover.
The practical mechanism is state change. Each step should tell the reader what to do, to which object, under which condition, and what visible result confirms that it worked. Prerequisites, branches, warnings and recovery notes stop the numbered list from becoming a false straight line.
Good instructions respect users. They do not blame a reader for discovering an unstated assumption, and they do not force one language or format where diagrams, demonstrations, translated support or accessible alternatives would help. English is the shared control layer when it is the working language.
This guide was checked on 13 October 2026. Real instructions must follow current school, workplace, manufacturer, accessibility, privacy and safety requirements. High-risk electrical, medical, chemical, legal or emergency tasks need approved procedures and competent supervision; a general writing guide cannot authorise them.
Did You Know? The U.S. government plain-language guide series says clear public content should be created, designed and tested for a specific audience. That makes instruction writing more than shortening sentences: the writer has to understand the user, organise the task and test whether the result is understandable.
Find the section you need
Define the route · 2 chapters
Write the actions · 2 chapters
Protect the reader · 2 chapters
Test the route · 2 chapters
Instructions begin with the person who will act and the result they must reach.
Name the user, prior knowledge, environment, authority, starting state and observable finish. State what the procedure includes and excludes before the first numbered action.
A club volunteer needs to publish an approved event notice, not design the event or change its date.
What to check
- Name user
- Name start
- Name finish
- Set scope
Try this chapter on a school portal upload. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: Do not assume that a job title proves familiarity with this version of the task.
Learning transfer: Audience and purpose support every school and workplace text.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
A reader should discover missing tools, files, permissions and information before beginning.
Create a short readiness list with materials, account access, approved inputs, time, location and dependencies. Link controlled sources and distinguish required from optional items.
Before uploading a class poster, the student needs the approved file, correct account, image rights confirmation and publication permission.
What to check
- List materials
- Check access
- Confirm inputs
- Mark dependency
Try this chapter on a club equipment handover. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: Never ask a reader to borrow credentials or bypass a permission barrier to satisfy the procedure.
Learning transfer: Prerequisite thinking supports project planning and science.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
A step is easier to follow when its main verb, object and result are visible.
Begin with an imperative verb, name the exact control or object, add only the conditions needed at that moment, and end with a checkable result. Split simultaneous or unrelated actions.
Select “Submit assignment,” choose the final PDF, then wait for the receipt showing the file name and time.
What to check
- Use active verb
- Name object
- Place condition
- Show result
Try this chapter on a family device setup. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: One action per step does not mean deleting a condition that protects meaning or safety.
Learning transfer: Sentence control supports procedural and examination writing.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
Numbering is meaningful only when order affects the outcome or the next step depends on the last.
Use numbered lists for sequence, bullets for unordered materials, and words such as before, after, only when and until for dependencies. Keep numbering stable across references.
Verify the file preview before selecting Submit; do not close the page until the receipt appears.
What to check
- Choose list type
- Mark dependency
- Keep numbering
- Show wait state
Try this chapter on a laboratory preparation checklist. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: Do not create false precision by numbering items that can occur in any order.
Learning transfer: Sequence language supports narratives, algorithms and experiments.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
Readers cannot act reliably on vague labels such as this, it, normal or the button.
Copy visible interface labels accurately, distinguish similar objects, give units and formats, and use the same term throughout. Add a locating cue without depending on colour alone.
Enter the date as DD/MM/YYYY in the “Event date” field; do not use “today” because the record may be reopened later.
What to check
- Copy label
- Use stable term
- Give format
- Avoid colour only
Try this chapter on a school portal upload. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: Interface labels and device behaviour can change, so identify the version or review date.
Learning transfer: Reference precision supports digital literacy and mathematics.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
Real tasks often split according to status, role, result or exception.
State the decision question, evidence to inspect, branch for each supported outcome and point where routes rejoin. Use tables or decision trees when prose becomes tangled.
If the receipt shows the new file name, continue to verification; if it shows the previous name, stop and reopen the upload step.
What to check
- Ask decision
- Name evidence
- Give branches
- Show rejoin
Try this chapter on a club equipment handover. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: Do not invent a branch for an unsupported condition; route it to an authorised owner.
Learning transfer: Conditional language supports coding and problem-solving.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
A warning works only when the reader sees it in time and understands the consequence and safe alternative.
Put the notice immediately before the relevant step. Name the hazard, who or what may be affected, the prohibited action, the protective action and the stop or escalation route.
Before replacing a shared file, confirm that the selected folder is the approved project folder; otherwise stop and ask the owner.
What to check
- Place early
- Name hazard
- Give protection
- Give stop route
Try this chapter on a family device setup. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: Do not dilute serious warnings by styling every tip as an emergency.
Learning transfer: Risk communication supports laboratories and work.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
8. Show recovery without normalising unsafe improvisation
Back to contentsReaders need to know how to recognise a failed step and which reversible response is permitted.
For expected errors, state the symptom, likely condition, safe retry limit, rollback or reset, evidence to preserve and escalation threshold. Keep destructive actions out of informal shortcuts.
If no receipt appears after one refresh, save the screen message and contact the assignment owner instead of uploading repeatedly.
What to check
- Name symptom
- Limit retry
- Preserve evidence
- Set escalation
Try this chapter on a laboratory preparation checklist. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: Recovery instructions must not encourage deletion, override or access beyond the user’s authority.
Learning transfer: Error recovery supports resilience and computing.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
A screenshot or diagram should help the reader locate, compare or understand a relationship.
Crop to the necessary context, label the action, provide alternative text, avoid exposing private data and pair the visual with written instructions that survive a layout change.
A screenshot highlights the file-name and receipt fields while the caption states what values to compare.
What to check
- Set purpose
- Protect data
- Write alt text
- Pair with prose
Try this chapter on a school portal upload. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: A screenshot of one version is not proof that every reader will see the same interface.
Learning transfer: Visual-text integration supports science and design.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
The author’s success is weak evidence because the author already knows the hidden model.
Observe a user attempting the task without coaching. Record pauses, wrong turns, questions, completion, time, accessibility barriers and unexpected conditions; revise the document, not the person.
A volunteer searches for a menu name that exists only in the writer’s memory, revealing that the instruction skipped a navigation step.
What to check
- Observe silently
- Record friction
- Test access
- Revise assumption
Try this chapter on a club equipment handover. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: One user can reveal problems but cannot represent every environment or access need.
Learning transfer: User testing supports inquiry and empathy.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
Instructions remain reliable only when readers can identify the current source and report drift.
Show title, owner, version, review date, applicable system or equipment, approval state, change summary and contact route. Archive superseded versions where the process requires it.
Version 3 adds the new receipt check after the portal changed; the owner records the date and retires the previous link.
What to check
- Name owner
- Date version
- Record change
- Set review
Try this chapter on a family device setup. Write the audience, present state, desired result, exact evidence, uncertainty, safe boundary and next action before polishing the sentences.
Now create an ordinary case, a difficult case and a missing-information case. Keep the governing meaning stable while adapting examples, detail and support for the reader.
Ask an independent reader to explain what they understood, what they would do next and where they hesitated. Revise the communication, preserve the source evidence and keep the first version beside the improvement.
Boundary: A document labelled current still needs review when the underlying system or rule changes.
Learning transfer: Version literacy supports lifelong learning.
Write one sentence that states the evidence, one that states its limit, and one that states the next responsible action. Then test each noun, number, condition and source against the current task and verified source. Replace vague confidence with a traceable reason.
How to build this kind of English before the job title arrives
Back to contentsStudents do not need professional authority to practise the underlying language. They can learn to define scope, annotate conditions, compare versions, rebuild a timeline, match a number to its unit and explain uncertainty without embarrassment. Parents can ask calm questions: What decision is this document supporting? Which sentence carries the strongest claim? What would make that claim false? Which source would you open next?
Use a three-pass routine. First, map the document: title, owner, audience, date, sections and decision. Second, trace one claim from source to conclusion. Third, explain the limit and next action. This routine strengthens comprehension, science, mathematics, humanities and workplace readiness because it turns English into an evidence tool.
A student should never imitate professional authority. The useful goal is to recognise when a text needs a qualified reviewer, current rule or official decision. Knowing when to pause is part of literacy.
Goal
A student uploads the final group report and confirms the accepted file.
Readiness
Approved PDF, correct account, stable connection and submission permission are checked first.
Route
The numbered actions name the visible controls, file and receipt state.
Branch
A mismatched file name leads to a safe correction path; no receipt leads to evidence capture and escalation.
Proof
A second student follows the instructions and can state the completed result without private coaching.
Context
User, start, outcome, scope, version and authority.
Readiness
Tools, files, permissions, knowledge, time and environment.
Action
Verb, object, value, condition and visible result.
Sequence
Order, dependency, wait state, branch and rejoin point.
Protection
Hazard, warning, prohibition, safeguard and stop condition.
Recovery
Symptom, safe retry, rollback, evidence and escalation.
Access
Headings, list structure, visual alternative, language and device needs.
Control
Owner, approval, date, revision trigger and feedback route.
Use this roadmap to see how the chapters connect. Each decision names a purpose, action, observable example and limit rather than repeating a generic writing rule.
1. Define the reader and finished state
Instructions begin with the person who will act and the result they must reach. The practical move is to name the user, prior knowledge, environment, authority, starting state and observable finish. State what the procedure includes and excludes before the first numbered action.
A reader can test the chapter through this example: A club volunteer needs to publish an approved event notice, not design the event or change its date. Keep the boundary visible: Do not assume that a job title proves familiarity with this version of the task.
2. List prerequisites before the sequence
A reader should discover missing tools, files, permissions and information before beginning. The practical move is to create a short readiness list with materials, account access, approved inputs, time, location and dependencies. Link controlled sources and distinguish required from optional items.
A reader can test the chapter through this example: Before uploading a class poster, the student needs the approved file, correct account, image rights confirmation and publication permission. Keep the boundary visible: Never ask a reader to borrow credentials or bypass a permission barrier to satisfy the procedure.
3. Give every step one clear action
A step is easier to follow when its main verb, object and result are visible. The practical move is to begin with an imperative verb, name the exact control or object, add only the conditions needed at that moment, and end with a checkable result. Split simultaneous or unrelated actions.
A reader can test the chapter through this example: Select “Submit assignment,” choose the final PDF, then wait for the receipt showing the file name and time. Keep the boundary visible: One action per step does not mean deleting a condition that protects meaning or safety.
4. Make sequence and dependency explicit
Numbering is meaningful only when order affects the outcome or the next step depends on the last. The practical move is to use numbered lists for sequence, bullets for unordered materials, and words such as before, after, only when and until for dependencies. Keep numbering stable across references.
A reader can test the chapter through this example: Verify the file preview before selecting Submit; do not close the page until the receipt appears. Keep the boundary visible: Do not create false precision by numbering items that can occur in any order.
5. Name objects, controls and values precisely
Readers cannot act reliably on vague labels such as this, it, normal or the button. The practical move is to copy visible interface labels accurately, distinguish similar objects, give units and formats, and use the same term throughout. Add a locating cue without depending on colour alone.
A reader can test the chapter through this example: Enter the date as DD/MM/YYYY in the “Event date” field; do not use “today” because the record may be reopened later. Keep the boundary visible: Interface labels and device behaviour can change, so identify the version or review date.
6. Write branches as decisions, not surprises
Real tasks often split according to status, role, result or exception. The practical move is to state the decision question, evidence to inspect, branch for each supported outcome and point where routes rejoin. Use tables or decision trees when prose becomes tangled.
A reader can test the chapter through this example: If the receipt shows the new file name, continue to verification; if it shows the previous name, stop and reopen the upload step. Keep the boundary visible: Do not invent a branch for an unsupported condition; route it to an authorised owner.
7. Place warnings before the hazardous action
A warning works only when the reader sees it in time and understands the consequence and safe alternative. The practical move is to put the notice immediately before the relevant step. Name the hazard, who or what may be affected, the prohibited action, the protective action and the stop or escalation route.
A reader can test the chapter through this example: Before replacing a shared file, confirm that the selected folder is the approved project folder; otherwise stop and ask the owner. Keep the boundary visible: Do not dilute serious warnings by styling every tip as an emergency.
8. Show recovery without normalising unsafe improvisation
Readers need to know how to recognise a failed step and which reversible response is permitted. The practical move is to for expected errors, state the symptom, likely condition, safe retry limit, rollback or reset, evidence to preserve and escalation threshold. Keep destructive actions out of informal shortcuts.
A reader can test the chapter through this example: If no receipt appears after one refresh, save the screen message and contact the assignment owner instead of uploading repeatedly. Keep the boundary visible: Recovery instructions must not encourage deletion, override or access beyond the user’s authority.
9. Use visuals as evidence, not decoration
A screenshot or diagram should help the reader locate, compare or understand a relationship. The practical move is to crop to the necessary context, label the action, provide alternative text, avoid exposing private data and pair the visual with written instructions that survive a layout change.
A reader can test the chapter through this example: A screenshot highlights the file-name and receipt fields while the caption states what values to compare. Keep the boundary visible: A screenshot of one version is not proof that every reader will see the same interface.
10. Test with a representative first-time user
The author’s success is weak evidence because the author already knows the hidden model. The practical move is to observe a user attempting the task without coaching. Record pauses, wrong turns, questions, completion, time, accessibility barriers and unexpected conditions; revise the document, not the person.
A reader can test the chapter through this example: A volunteer searches for a menu name that exists only in the writer’s memory, revealing that the instruction skipped a navigation step. Keep the boundary visible: One user can reveal problems but cannot represent every environment or access need.
11. Control the version, owner and feedback route
Instructions remain reliable only when readers can identify the current source and report drift. The practical move is to show title, owner, version, review date, applicable system or equipment, approval state, change summary and contact route. Archive superseded versions where the process requires it.
A reader can test the chapter through this example: Version 3 adds the new receipt check after the portal changed; the owner records the date and retires the previous link. Keep the boundary visible: A document labelled current still needs review when the underlying system or rule changes.
The completed route should let another person reconstruct what the communication is for, what evidence supports it, what remains uncertain and what happens next.
Each case asks the learner to compare a quick answer with a version another person can actually use.
Case 1: Define the reader and finished state
Start with the worked situation: A club volunteer needs to publish an approved event notice, not design the event or change its date. Write the most tempting shortcut, then mark the missing reader need, condition, source, authority or next action.
Repair the communication by applying this method: Name the user, prior knowledge, environment, authority, starting state and observable finish. State what the procedure includes and excludes before the first numbered action. Finish by stating why this boundary still matters: Do not assume that a job title proves familiarity with this version of the task.
Case 2: Make sequence and dependency explicit
Start with the worked situation: Verify the file preview before selecting Submit; do not close the page until the receipt appears. Write the most tempting shortcut, then mark the missing reader need, condition, source, authority or next action.
Repair the communication by applying this method: Use numbered lists for sequence, bullets for unordered materials, and words such as before, after, only when and until for dependencies. Keep numbering stable across references. Finish by stating why this boundary still matters: Do not create false precision by numbering items that can occur in any order.
Case 3: Place warnings before the hazardous action
Start with the worked situation: Before replacing a shared file, confirm that the selected folder is the approved project folder; otherwise stop and ask the owner. Write the most tempting shortcut, then mark the missing reader need, condition, source, authority or next action.
Repair the communication by applying this method: Put the notice immediately before the relevant step. Name the hazard, who or what may be affected, the prohibited action, the protective action and the stop or escalation route. Finish by stating why this boundary still matters: Do not dilute serious warnings by styling every tip as an emergency.
Case 4: Test with a representative first-time user
Start with the worked situation: A volunteer searches for a menu name that exists only in the writer’s memory, revealing that the instruction skipped a navigation step. Write the most tempting shortcut, then mark the missing reader need, condition, source, authority or next action.
Repair the communication by applying this method: Observe a user attempting the task without coaching. Record pauses, wrong turns, questions, completion, time, accessibility barriers and unexpected conditions; revise the document, not the person. Finish by stating why this boundary still matters: One user can reveal problems but cannot represent every environment or access need.
A parent, tutor, teacher or colleague can ask questions, but the learner should make the final revision in their own words and keep evidence of what changed.
Clear English is reliable when the reader can see not only what the sentence says, but also where it stops.
Boundary 1: Give every step one clear action
A step is easier to follow when its main verb, object and result are visible. Before treating the wording as complete, identify an exception, a missing fact, a reader who may need another route and a change that would force revision.
Apply the chapter’s observable signal—Select “Submit assignment,” choose the final PDF, then wait for the receipt showing the file name and time.—and underline the exact words carrying scope, time, permission, comparison or uncertainty. One action per step does not mean deleting a condition that protects meaning or safety.
Boundary 2: Write branches as decisions, not surprises
Real tasks often split according to status, role, result or exception. Before treating the wording as complete, identify an exception, a missing fact, a reader who may need another route and a change that would force revision.
Apply the chapter’s observable signal—If the receipt shows the new file name, continue to verification; if it shows the previous name, stop and reopen the upload step.—and underline the exact words carrying scope, time, permission, comparison or uncertainty. Do not invent a branch for an unsupported condition; route it to an authorised owner.
Boundary 3: Use visuals as evidence, not decoration
A screenshot or diagram should help the reader locate, compare or understand a relationship. Before treating the wording as complete, identify an exception, a missing fact, a reader who may need another route and a change that would force revision.
Apply the chapter’s observable signal—A screenshot highlights the file-name and receipt fields while the caption states what values to compare.—and underline the exact words carrying scope, time, permission, comparison or uncertainty. A screenshot of one version is not proof that every reader will see the same interface.
Boundary 4: Control the version, owner and feedback route
Instructions remain reliable only when readers can identify the current source and report drift. Before treating the wording as complete, identify an exception, a missing fact, a reader who may need another route and a change that would force revision.
Apply the chapter’s observable signal—Version 3 adds the new receipt check after the portal changed; the owner records the date and retires the previous link.—and underline the exact words carrying scope, time, permission, comparison or uncertainty. A document labelled current still needs review when the underlying system or rule changes.
A bounded statement is useful because a reader can test it, ask a focused question and act without treating confidence as proof.
Audience adaptation changes emphasis, vocabulary and next steps; it does not authorise a different truth.
Learner
Instructions begin with the person who will act and the result they must reach. This reader may need a different level of detail or a different next action.
Preserve name user, name start, name finish, set scope while adapting examples and support. Do not change the underlying fact, decision or limit simply to make the short version easier.
Teacher or mentor
A step is easier to follow when its main verb, object and result are visible. This reader may need a different level of detail or a different next action.
Preserve use active verb, name object, place condition, show result while adapting examples and support. Do not change the underlying fact, decision or limit simply to make the short version easier.
Parent or colleague
Readers cannot act reliably on vague labels such as this, it, normal or the button. This reader may need a different level of detail or a different next action.
Preserve copy label, use stable term, give format, avoid colour only while adapting examples and support. Do not change the underlying fact, decision or limit simply to make the short version easier.
Reviewer
A warning works only when the reader sees it in time and understands the consequence and safe alternative. This reader may need a different level of detail or a different next action.
Preserve place early, name hazard, give protection, give stop route while adapting examples and support. Do not change the underlying fact, decision or limit simply to make the short version easier.
Future reader
A screenshot or diagram should help the reader locate, compare or understand a relationship. This reader may need a different level of detail or a different next action.
Preserve set purpose, protect data, write alt text, pair with prose while adapting examples and support. Do not change the underlying fact, decision or limit simply to make the short version easier.
Successful transfer preserves identity, source, status, uncertainty, boundary and responsible action while making the route easier for this reader to follow.
A polished paragraph can still conceal an unclear purpose, missing condition, invisible assumption or stale source.
Purpose test
State in one sentence what the reader should understand, decide or do. Delete a detail only if its removal does not change that outcome or a necessary boundary.
Write the expected interpretation, the reader’s actual interpretation, the difference and one precise revision. Keep the earlier version so the learning remains visible.
Condition test
Circle words such as if, unless, before, after, may, must and only. Add the missing role, date, version or exception beside each one.
Write the expected interpretation, the reader’s actual interpretation, the difference and one precise revision. Keep the earlier version so the learning remains visible.
Independent-reader test
Give the communication to someone who was not present. Ask what they think is true, what is still unknown and what action they would take next.
Write the expected interpretation, the reader’s actual interpretation, the difference and one precise revision. Keep the earlier version so the learning remains visible.
Change test
Imagine that a deadline, interface, source, role or policy changes tomorrow. Mark every sentence needing review and name who will update it.
Write the expected interpretation, the reader’s actual interpretation, the difference and one precise revision. Keep the earlier version so the learning remains visible.
Close reading is practical care: it keeps language from outrunning the reader, the evidence or the authority behind it.
Answer each prompt in a complete sentence tied to the current task, source, reader or authorised clarification. Write “unknown” when the available information does not support an answer.
- Name user? State the evidence, the limit and the narrow next action it supports.
- Name start? State the evidence, the limit and the narrow next action it supports.
- Name finish? State the evidence, the limit and the narrow next action it supports.
- Set scope? State the evidence, the limit and the narrow next action it supports.
- List materials? State the evidence, the limit and the narrow next action it supports.
- Check access? State the evidence, the limit and the narrow next action it supports.
- Confirm inputs? State the evidence, the limit and the narrow next action it supports.
- Mark dependency? State the evidence, the limit and the narrow next action it supports.
- Use active verb? State the evidence, the limit and the narrow next action it supports.
- Name object? State the evidence, the limit and the narrow next action it supports.
- Place condition? State the evidence, the limit and the narrow next action it supports.
- Show result? State the evidence, the limit and the narrow next action it supports.
Read it aloud
Listen for sentences that postpone the answer, hide the actor, overload one step or imply certainty that the source does not provide. Revise for meaning before tone.
Ask a real reader
Invite a learner, parent, colleague or mentor to identify the purpose, strongest claim, important condition and next action. Treat hesitation as useful evidence about the text.
Keep a small revision note
Record the source, date, change and reason. A short history helps the next writer avoid restoring an earlier ambiguity.
How many actions belong in one step?
Usually one main action, with the condition and visible result needed to perform it correctly.
Should every instruction be numbered?
Use numbers when order matters; use bullets for materials or choices that do not have a sequence.
Are screenshots enough?
No. Pair them with text, protect private information and plan for interface changes.
How should I write a warning?
Place it before the hazardous action and name the hazard, consequence, protection and stop route.
What if the user encounters an unknown error?
Ask them to preserve the evidence, stop unsafe retries and contact the authorised owner.
How do I know the instructions work?
Observe a representative first-time user and revise every hidden assumption the test reveals.
- Digital.gov Plain Language Guide Series
- W3C: Headings
- Why English? Reading Assignment Instructions
- Why English? Reading Software Error Messages and Documentation
Cycle-sensitive facts were checked against current official pages on 13 October 2026. Always reopen the authority’s live page before a real decision.
