Test a working document

Use this for a procedure, shared reference, or recurring report. Test it against a real task with someone who would normally use it.

1. Choose a task.
State what the reader needs to do or decide. Select a recent or safely simulated instance. Identify the source material and any information that must remain restricted.

2. Find the required information.
List what the reader needs at each step. Mark which facts change, where authoritative values come from, and who can answer unresolved questions.

3. Prepare a usable version.
Put the task, inputs, steps, decision points, and expected output in order. Identify the owner, version date, and update trigger. Link to authoritative information when copying it would create inconsistent versions.

4. Observe someone using it.
Ask a colleague to carry out the task using the document. Record where they search, pause, ask for clarification, or choose the wrong action. Obtain consent for observation and any recording.

5. Revise the specific problem.
Change the wording, ordering, or reference that caused difficulty. Repeat the affected part of the task. Check whether the revision creates a new ambiguity elsewhere.

6. Assign upkeep.
Agree where the document lives, who maintains it, and what prompts a review. Make the current version easy to identify. Recheck it when the work, system, or decision authority changes.

WORKSHEET

Task and intended reader:


Required inputs and authoritative sources:


Access restrictions:


Steps and decision points:


Expected output:


Owner, date, location, and update trigger:


Observed pauses, questions, and errors:


Revision and retest result:


Remaining questions and next review:


Check whether a reader can complete the task accurately, locate the current version, and recognize when they need help. Record unresolved cases. Keep safeguards and required approvals visible. One successful use provides evidence for that task and reader.

REASONING

A unit label addresses the ambiguity observed in the entries. The retest checks whether another person records the same stock consistently. If errors continue, check packaging conversions and the clarity of the example before adding further instructions.

Try the reasoning on another instance

Ask a colleague to apply the worksheet to another safe instance and explain their decision. Record what they found unclear and when they would ask for help.

Explanation being tested:


Other possible explanation:


Observation that would change the decision:


What another person needed to use this method: