Library / Explanation Design Principles Framework
Jump to passage
In this reading

Link to current text

Published source confirmed at last check

Source changed 2026-10-03 08:25:59 UTC · snapshot created 2026-10-03 08:26:43 UTC · last check 2026-10-03 09:10:20 UTC

EXD.1 - Establish and Revise What a Recipient Needs Explained

EXD.1:1 - Problem frame

Use this pattern when someone needs an explanation and the needed connection, contrast or use is still unclear, or when a contribution changes what the explanation should answer. The reader may be preparing a lesson, explaining a technical account, discussing advice or assisting a human–AI exchange.

Begin with the recipient’s request and the situation in which its answer matters. Ask the smallest question that distinguishes the consequential alternatives. A usable first result is a question the participants can answer under named conditions, together with the intended use and the subject input still needed.

When a request already identifies a sufficient question, use it. “Show how the total of these eight values gives their mean” can lead directly to the available calculation. Additional elicitation is useful when it can change the next explanation.

EXD.1:2 - Problem

“Why is this wrong?” can hide several questions. The recipient may have made a calculation error, used a different aggregation rule, questioned a premise or asked whether the result serves a decision. Answering the first interpretation that comes to mind can produce a valid account whose decisive relation is irrelevant to the recipient.

Preparation is also easy to misread. A course title, professional role or fluent acknowledgement does not reveal whether the person can use the particular relation needed now. Question work must recover enough of that local understanding to choose the next contribution without turning every request into an assessment session.

EXD.1:3 - Forces

ForcePractical tension
A quick answer and a consequential ambiguityA short request may already be clear; a small clarification can also prevent a long explanation of the wrong question.
The subject and the recipient’s purposeThe subject constrains which answers are warranted. The recipient’s purpose selects which of those answers is useful.
Available knowledge and added burdenAn initial attempt can reveal the missing relation, but requiring a demonstration adds work and can distract from a simple request.
Continuity and revisionEarlier explanation can remain correct while a changed purpose makes another question current.

EXD.1:4 - Solution

EXD.1:4.1 - Recover the requested connection and its use

Start with the recipient’s own words and the task at hand. Identify what the answer would let them infer, distinguish, predict, calculate or do. Keep the question and purpose distinguishable: “What is the average across these people?” asks for a statistic; “I need a fair comparison of branches” states a purpose whose rule of fairness remains to be settled.

When alternatives would lead to different answers, offer a brief discriminating clarification. For an average, ask whether each individual or each group should receive equal influence. For a recommendation, ask whether the recipient needs its existing grounds or evidence that following it will develop a capability. Choose the contrast from the actual task and available account.

Accept a clear answer, a corrected paraphrase or a still-unresolved choice. If the recipient cannot choose, state the conditional questions. “We can calculate either summary; we still need to decide which unit should count equally” is a useful result.

EXD.1:4.2 - Locate usable preparation at the needed grain

Use what the recipient has already supplied: a question, attempted calculation, annotation, example, objection or description of intended use. If the next contribution depends on a particular prerequisite and that prerequisite is uncertain, ask for a small relevant inference. “What total does a group of six with mean eight contribute?” tests the needed relation more directly than asking whether the person knows statistics.

Treat the response as evidence about this task under its conditions. If you supply the multiplication step before the person answers, their later answer is assisted. Preserve that distinction when it matters to choosing help or judging independent use. A recipient asking for advice may need only a premise explained; an instructional diagnosis is then unnecessary.

When interaction is unavailable, prepare from the known audience and task. State assumptions that change the answer, expose the relevant alternatives in the text and provide a usable return. A reader can select an explicit branch without first completing a questionnaire.

EXD.1:4.3 - Form the question that the subject can answer

State the target relation, relevant conditions and the needed answer. A short sentence usually suffices: “For these eight values, why does equal weight per individual require weighting the group means by their counts?” Obtain its subject basis through Obtain and Carry the Subject Explanation.

If the requested connection lacks a warranted account, return that question to the relevant subject work. A causal claim may need an investigation; a recommendation may need another premise; a mathematical answer may need a definition or proof. Keep the question available while that work proceeds. Polished wording cannot close a missing warrant.

EXD.1:4.4 - Revise when a contribution changes the target

Compare a new contribution with the current question. Does it reveal a different intended use, change a relevant condition, dispute the subject basis or expose an error under the same question? Make the consequence explicit in the next explanation.

For a changed target, state the new question and what remains valid from the earlier answer. For an error under the same target, retain the target and repair the affected inference. For a disputed premise, recover or revise the subject account. In an exchange, use EXD.4 to choose and interpret the next contribution.

Stop when the question is clear enough to select the required account and a useful next explanation, or when a specific unresolved input has an actionable return. A formal question record is useful only when the work needs one.

EXD.1:5 - Archetypal Grounding

A learner asks why averaging two group means gave the wrong result. Group A has the values 2 and 4; group B has six values of 8. The initial task explicitly asks for the mean across all eight individuals. The learner can add and divide but has used (3 + 8) / 2 = 5.5.

A useful question statement is: “Why do the group sizes matter when we give every individual equal weight?” The account reconstructs the group sums, 2 × 3 = 6 and 6 × 8 = 48, and divides 54 by eight to obtain 6.75. If the missing connection is that count multiplied by mean reconstructs sum, the explanation must expose it.

The recipient then says, “For my report, I want each branch to count equally, regardless of how many people it has.” This explicitly selects a different aggregation rule, so the explainer can answer the revised question directly.

The revised question is the equally weighted mean of the branch means. Its answer is 5.5. Close with the label and condition: “Mean of branch means, each branch weighted equally: 5.5.” The earlier 6.75 remains correct for the average across individuals. The management justification for choosing one summary still belongs to the report’s decision.

This is a constructed case. Its arithmetic fixes the local answer criteria; the conversation illustrates the proposed question work. It supplies no measured learning result.

In a different use, an adviser has explained why a bounded coordination assignment fits Mira’s demonstrated strengths and available protected time. Mira asks why doing it would teach a missing capability. Recover the new learning question and obtain its learning rationale. Repeating the evidence of existing strengths does not supply that additional connection. If Mira instead understands the recommendation and prefers a course’s social setting, the new contribution concerns preference and advising.

EXD.1:6 - Bias-Annotation

The explainer’s expertise can make one interpretation seem inevitable. Begin with the actual requested use and keep a serious alternative visible when it would change the answer. A question bank can reveal possibilities, but its categories may constrain what recipients ask; allow them to supply their own question and reason.

The instructional case makes a correct answer easy to compute. In technical or advisory work, disagreement about the basis can remain unresolved even after the question is clear.

EXD.1:7 - Conformance Checklist

For recognition, locate a consequential ambiguity, missing prerequisite or changed question. If the supplied question already supports a useful answer, direct use is enough.

For assurance of this question result, check that:

  • the question and the purpose can be distinguished;
  • the selected relation and action-changing conditions are explicit enough to choose a subject account;
  • any preparation claim has an actual task basis or is stated as an assumption;
  • a new contribution changes the appropriate question, premise, help or interpretation;
  • an unresolved input has a specific return, or the current question has a usable next answer.

These checks concern the question and its use. Retention and transfer need their corresponding evidence.

EXD.1:8 - Common Anti-Patterns and How to Avoid Them

Failure visible in useRepair
Repeating why 5.5 is wrong after the recipient selects equal branch weightRestate the changed aggregation question and answer it under its own rule.
Taking “I understand” or a qualification as evidence of the needed inferenceUse an already available response or one relevant inference when that distinction can change assistance.
Treating an elicited list as a complete account of the recipient’s needAsk what the question would help them do and allow an unlisted contribution.
Reopening a clear request with an elaborate interviewUse the sufficient question and return to clarification only when a consequential uncertainty appears.

EXD.1:9 - Consequences

The next explanation can target a relation the recipient needs and the subject can support. A changed purpose becomes a reason to revise the target rather than a reason to repeat or lengthen the same account.

This work costs attention and can expose a decision or source gap that the explainer cannot settle. The useful stopping point is then a bounded question and return, with any independently supported answer retained.

EXD.1:10 - Architectural Rationale

A question is useful before a text is prepared and within a live exchange. Its first result therefore deserves direct access. The dialogue pattern uses that result and can return a changed question; it also governs contribution size, feedback and repair that question formation alone does not provide.

Separating purpose from question prevents a mathematical definition from silently deciding an aggregation policy. Separating preparation from the answer prevents added help from being mistaken for independent knowledge. Both distinctions change the smallest useful next move.

EXD.1:11 - SoTA-Echoing

Liao et al., 2021 connect question elicitation in concrete tasks with the purposes and explanatory solutions that can answer them. Adapt that move to the recipient’s intended inference and actual subject. A generic catalogue is a useful prompt; one discriminating task question can be sufficient.

Schmude et al., 2025 used free questions, a question bank and clarification in two algorithmic-decision scenarios with 24 participants. Their exploratory work supports allowing recipients to state why information matters and to go beyond prepared categories. It establishes neither completeness of the bank nor a general comprehension effect.

Galbraith and Khalifa, 2026, §§2 and 5 propose an interrogative account of understanding while leaving important epistemic conditions open. Use the question discrimination; subject warrant still comes from the relevant account. The procedure here is a bounded explanation-practice adaptation.

At the same practical grain, “Why is 5.5 wrong?” and “Which unit receives equal weight?” can both be brief. The latter distinguishes the live alternatives in the worked case. That conceptual advantage does not establish a measured reduction in conversation time. Reopen the adaptation when a recurring use cannot express its needed distinction through the proposed question work.

EXD.1:12 - Relations

EXD.4 uses and revises the question during an exchange. The supplied-account entry obtains the answer’s subject relations and conditions.

FPF A.2.9 supplies communicative-use distinctions where that analysis is needed. C.2.8 characterizes what a particular observer can recover from an account and form under selected conditions; it does not choose the question’s purpose.

EXD.1:End

Referenced in the corpus

31 literal mentions in other sections. Read their context to establish the relation.