Inline Clarifier¶
Point-of-use annotation — instantiates Polysemy Disambiguation
Drops a terse point-of-use cue — parenthetical, tooltip, or microcopy — that signals the intended sense right where the user acts, without sending them to documentation.
An inline clarifier drops a terse cue — a parenthetical, a tooltip, a hover definition, a scrap of microcopy — right where a term is encountered, signaling the intended sense at the exact moment the user reads or acts, so they never have to leave the page to consult documentation. Its defining constraint, against a glossary or a definition note, is proximity under action: it assumes the user will not, and cannot be made to, go look the term up, so the clarification must be delivered in place and compressed to a few words. It carries the active sense to the point of use rather than storing it in a reference somewhere the user will never open.
Example¶
A consumer tax-filing web app asks users to enter the number of "dependents." Ordinary users conflate several senses: people they financially support, people who live with them, and the specific tax sense (a qualifying child or qualifying relative who meets the filing rules). Errors here cause rejected returns. Rather than link out to a twenty-page publication, the app puts an inline clarifier beside the field. The label itself reads "Dependents (people who qualify under the filing rules — usually a child or relative you support who lives with you)," and a small "?" reveals a two-line tooltip with the quick tests and a pointed aside: "Not a dependent: a roommate, or your spouse." The cue sits exactly where the user types the number. Rejected returns from over-counted dependents drop, because the governing sense — and the near-miss it excludes — arrives at the moment of the entry, not in a document the user was never going to read.
How it works¶
- Identify the moment of interpretation — the field, the label, the sentence where the reader acts on the term.
- Compress the governing sense into a few words that fit in place without stopping the reader.
- Add a progressive layer — a hover or tap that reveals the fuller definition for the user who wants it — so the top-level cue can stay short.
- Keep the top layer terse, short enough to read at a glance.
It is the delivery, at the point of action, of a sense that may be defined more fully elsewhere — not the authoritative record of that sense.
Tuning parameters¶
- Cue verbosity — a two-word parenthetical versus a full tooltip. Longer cues clarify more but interrupt flow.
- Trigger mode — always-visible microcopy versus on-demand hover or tap. Always-visible guarantees exposure but adds clutter; on-demand stays clean but can go unseen.
- Layer depth — a single cue versus progressive disclosure down to fuller detail. More layers serve varied users but cost more to build.
- Placement — adjacent to the term versus a nearby help icon. Adjacency maximizes the catch rate; an icon keeps the interface tidy but is easier to skip.
When it helps, and when it misleads¶
Its strength is that it reaches users who will never read documentation — the only mechanism here that clarifies during action. It is an application of progressive disclosure to meaning: the intended sense appears exactly where the user acts, and fuller definition stays one hover away.[n1] Its failure modes are clutter and habituation — clarifiers on every term become visual noise users learn to tune out — and misleading compression, where a too-short cue oversimplifies the sense it fronts. The classic misuse is a chirpy tooltip used to paper over a term that is genuinely under-specified and actually needs a real definition. The guarding discipline is to clarify only the terms that provably cause errors, keep the top layer short, and make sure the compressed cue stays faithful to the fuller definition it stands in for.
How it implements the components¶
active_sense— it delivers the one governing sense at the point of use, right where the reader must act.context_cue— the in-place parenthetical or tooltip is itself the signal by which the user identifies the intended sense.qualifier_or_example— the compressed clarifier, with its quick "not a…" aside, is the point-of-use qualifier that steers interpretation in the moment.
Its cue points to one sense but does not name the whole set of coexisting senses (meaning_cluster) — that is its nearest twin Sense Labeling, whose persistent labels tag every sense of the cluster rather than clarifying one in place; nor does it collect definitions into a bounded reference (sense_inventory, Context-Specific Glossary) or verify that misreadings stopped (misunderstanding_monitor, Terminology Review Workshop).
Related¶
- Instantiates: Polysemy Disambiguation — it is the deliver-at-the-point-of-use variant, for readers who will not consult a reference.
- Consumes: Definition Note — the inline cue surfaces, in compressed form, the governing sense a definition note or glossary holds in full.
- Sibling mechanisms: Controlled Vocabulary · Sense Labeling · Definition Note · Examples and Non-Examples · Context-Specific Glossary · Legal Definition Clause · Terminology Review Workshop
Editorial Notes¶
Form Classification¶
Form family: Interface, Display & Cue
Rationale: Inline Clarifier operates as a user-facing prompt, display, template, or perceptual cue that shapes attention and action at the point of use because it drops a terse point-of-use cue — parenthetical, tooltip, or microcopy — that signals the intended sense right where the user acts, without sending them to documentation
Independent corroboration: The frozen evidence defines Inline Clarifier as 'Drops a terse point-of-use cue — parenthetical, tooltip, or microcopy — that signals the intended sense right where the user acts, without sending them to documentation', so its operative form is Interface, Display & Cue.
Review outcome: Independent reviewer agreement; high confidence.
Origin Attribution¶
Primary origin: Human-Computer Interaction
Origin pattern: Convergent development
Present-day reach: Universal
Rationale: Tooltips, microcopy, and progressive point-of-use disclosure are established interaction-design practices.
Related originating lineages:
- Linguistics & Semiotics — Lexical polysemy and sense disambiguation materially define the semantic problem the cue resolves.
Review resolution: Both independent reviews place the primary lineage in human_computer_interaction. The queued differences (domain_reach_disagreement) concern secondary metadata rather than primary provenance. The final retains linguistics_semiotics only where a reviewer supplied a formative-lineage rationale; this does not convert downstream applicability into origin. origin_mode=convergent because the reviewers document independently established or materially co-developing traditions. domain_reach=universal records application breadth separately from provenance.
Review outcome: Reconciled after independent review; high confidence.
Notes¶
[n1] Progressive disclosure is a user-interface principle: show only what is needed at each step and reveal detail on demand. An inline clarifier applies it to meaning — the intended sense appears exactly where the user acts, while the fuller definition stays one hover or tap away. ↩