Jargon Inventory and Glossary¶
Reference artifact — instantiates Recipient Knowledge-State Calibration
Inventories every specialist term in the material and pairs each with a recipient-facing definition, building a shared vocabulary both sides agree to use.
Jargon Inventory and Glossary operates at the level of the term. It sweeps the material for specialist words, acronyms, and terms of art, and pairs each with a plain, recipient-facing definition — producing a durable lookup artifact and, once both parties adopt it, an agreed shared vocabulary. Its defining move, and what separates it from its prose-rewriting sibling, is that the unit of work is the individual word: it does not restructure sentences or lower the reading level of running text, it resolves the specific tokens that mean nothing (or the wrong thing) to the recipient. A glossary is the cheapest, most reusable calibration output there is — and also the most easily overrated, because defining words is not the same as rebuilding the reasoning those words carry.
Example¶
An insurance carrier is redesigning a homeowner's policy so ordinary customers can understand what they bought. A jargon inventory sweeps the document and flags the load-bearing terms: subrogation, deductible, rider, indemnity, actual cash value versus replacement cost. Each gets a definition written for a policyholder, not a lawyer — "subrogation: after we pay your claim, we can go after whoever caused the damage to recover the money; you don't owe anything, but you agree not to separately settle with them." The finished glossary is published inside the policy and referenced by both the customer and the claims adjuster, so a later dispute turns on the agreed meaning rather than two private ones. The inventory found nineteen terms; the customer's real question — why replacement cost changes the premium — needs more than a definition, and the glossary is honest that it only fixes the vocabulary.
How it works¶
The distinctive discipline is term-by-term coverage and a definition aimed at the recipient's frame, then adoption as canonical:
- Harvest from both directions. Collect candidate terms the expert flags as jargon and the words real recipients report as opaque — the two lists rarely match, and the recipient's list catches the "obvious" terms the expert never notices.
- Define in the recipient's language. Each entry is written to the audience's baseline, using no term that itself needs the glossary; where a specialist word is truly unavoidable, it is defined on first use and every use points back to the entry.
- Make it the shared contract. The glossary is published as the canonical meaning both sides commit to, so the same word does not carry two interpretations across a later exchange.
Tuning parameters¶
- Inclusion threshold — how specialized a word must be to earn an entry. A low threshold defines nearly everything (safe but bloated and condescending); a high one keeps the glossary lean but can skip a term one segment finds opaque.
- Definition depth — a one-line gloss versus a fuller explanation with an example. Depth aids understanding but pushes the glossary toward being the explanation itself, which is not its job.
- Placement — inline definition on first use, hover/expandable, or a back-of-document list. Inline aids flow; a consolidated list is easier to maintain and reuse.
- Canonicalization strictness — whether the glossary is advisory or the binding shared meaning both parties must use. Binding removes ambiguity but demands upkeep as usage drifts.
When it helps, and when it misleads¶
Its strength is removing term-level opacity in a durable, reusable form: one well-built glossary serves every future reader, and pinning terms to an agreed meaning heads off the failure where two parties "agree" in a meeting and later act from different definitions of the same word.[1]
Its failure mode is the archetype's sharpest trap for this mechanism: jargon can be fully defined while the hidden causal model, decision rule, or sequence of steps stays missing. A reader who now knows what "subrogation" means still may not know why it matters to their choice. The classic misuse is shipping a glossary as proof the material is accessible — a fig leaf that satisfies a plain-language checkbox while the reasoning remains locked. The discipline that keeps it honest is to treat the glossary as necessary but never sufficient, and to pair it with a mechanism that rebuilds the missing reasoning rather than letting defined terms stand in for understanding.
How it implements the components¶
Jargon Inventory and Glossary fills the term-translation side of the archetype — the vocabulary layer beneath everything else:
jargon_and_term_translation_map— the inventory-plus-definitions is the map from each specialist term to a recipient-accessible rendering.common_ground_contract— adopted as canonical, the glossary is the explicit shared-vocabulary agreement both sides commit to using, so a word carries one meaning across the exchange.
It does not rewrite running prose to a target reading level or guard the precision of full sentences (accessibility_and_language_constraint_check) — that is Plain-Language with Precision Review; the glossary translates isolated terms, not paragraphs.
Related¶
- Instantiates: Recipient Knowledge-State Calibration — the glossary supplies the shared vocabulary the rest of the rebuild rests on.
- Sibling mechanisms: Comprehension Usability Test · Expert Compression Red Team · Novice Walkthrough · Plain-Language with Precision Review · Prerequisite Mapping Workshop · Recipient Question Log · Teach-Back Protocol · Worked Example Ladder
Editorial Notes¶
Form Classification¶
Form family: Representation, Specification & Plan
Rationale: Jargon Inventory and Glossary operates as a non-executable information artifact that externalizes static or prospective structure because it inventories every specialist term in the material and pairs each with a recipient-facing definition, building a shared vocabulary both sides agree to use
Independent corroboration: The frozen evidence defines Jargon Inventory and Glossary as 'Inventories every specialist term in the material and pairs each with a recipient-facing definition, building a shared vocabulary both sides agree to use', so its operative form is Representation, Specification & Plan.
Nearest alternative: Rule, Policy & Commitment — Although adopted as canonical vocabulary, the operative artifact is a recipient-facing glossary rather than the agreement itself.
Review outcome: Independent reviewer agreement; medium confidence.
Origin Attribution¶
Primary origin: Linguistics & Semiotics
Origin pattern: Cross-disciplinary synthesis
Present-day reach: Universal
Rationale: Terminology and plain-language traditions supplied systematic identification and recipient-facing definition of specialist vocabulary.
Related originating lineages:
- Communication & Media Studies — Audience-centered communication practice shaped calibration to the recipient's knowledge state.
- Law & Governance — Legal drafting and consumer disclosure practice materially shaped agreed definitions for consequential terms.
- Library & Information Science — Knowledge organization contributed controlled-vocabulary management and glossary maintenance.
Review resolution: Both independent reviews place the primary lineage in linguistics_semiotics. The queued differences (alternate_origin_disagreement, domain_reach_disagreement) concern secondary metadata rather than primary provenance. The final retains communication_media_studies, law_governance, library_information_science only where a reviewer supplied a formative-lineage rationale; downstream application by itself is not treated as origin. origin_mode=cross_disciplinary_synthesis records the relationship among origin traditions, while domain_reach=universal records application breadth separately. encyclopedia_synthesis=true reflects whether either reviewer identified a corpus-specific synthesis, and confidence=medium preserves the more cautious evidence assessment.
Encyclopedia synthesis: The exact catalogued form synthesizes established practice rather than reproducing a single standard historical label.
Review outcome: Reconciled after independent review; medium confidence.
References¶
[1] The Plain Writing Act of 2010, a U.S. federal law requiring agencies to write public-facing material in "clear, concise, well-organized" language, is the best-known institutional push behind plain-language work. It also illustrates this mechanism's limit: mandating plain wording, including defined terms, does not by itself guarantee that readers can act on the material. registry ↩