EXD-REPAIR — Repair what the recipient cannot use without rewriting everything
Situation: An explanation fails in use, and plausible repairs include more subject content, another form or additional help. These changes would contribute different things.
Question: Which repair addresses the actual difficulty, and is it worth its burden compared with the available explanation?
Possible result: a justified repair, an adequate explanation to retain, or the subject or reader evidence missing for the particular comparison.
Start with EXD.6 - Compare Explanations for the Recipient’s Use and Decide Whether a Repair Is Worthwhile. Identify the relation the recipient needs and the criterion for its use.
Stop or return. Keep an explanation that satisfies the intended use. A supported subject result can justify correcting an explicit false claim. For a mathematical error, the definitions may suffice. For a question about what a reader can recover, use suitable existing evidence or obtain an observation if its attainable contribution warrants the effort.
- Identify the required relation. Consider a proposed explanation of active effort on one person’s task. The accounting rule counts time spent working on that task. The draft instead uses the elapsed time from start to handoff. On an uninterrupted task they agree, so that case cannot distinguish the rules.
- Choose an example that distinguishes the rules. Work from 09:00 to 10:00 and again from 11:00 to 12:00 gives two hours of active effort and three hours elapsed, provided the person does no task work in the intervening hour. Use EXD.2 to explain why the rules differ. If a table helps, use EXD.3 to show the intervals and label the two quantities. Correct the rule itself wherever it equates effort with elapsed time.
- Identify any remaining difficulty. If a recipient still counts the interruption, use EXD.4 to find out what their answer means. If they need practice, ask them to explain how each interval enters the calculation. Use EXD.5 to give feedback on that explanation and offer a changed case when useful. Keep any initial answer and the help received. A knowledgeable reader may have corrected the draft from prior knowledge. A later correct answer may depend on the help.
- Choose the conclusion the evidence supports. The accounting rule justifies correcting the draft. Faster reading or better learning with the table requires evidence about those outcomes. If accurate prose already serves the task, retain it. Repeated comparison of corresponding intervals might justify another form. When comparing forms, keep the claims and the available help comparable.
If the task changes to concurrent work by several people, establish what total is wanted and how each person’s effort counts. The one-person example does not determine the answer. Use HCD.18 or HCD.19 to assess an instructional material and the relevant HCD method for claims about later human performance, transfer or retention. A correction to the explanation may already finish the present task.