Gloss the Translation Surface

Heart

When a new contributor arrives with a predicate, term, or classification that overlaps with an existing one but does not collapse into it, write a Gloss that names each term, cites the tradition each comes from, and names the distinction each preserves. The Gloss is the translation layer at the contact surface — the concrete move that turns [[Translation Over Convergence]] from stance into practice.

Problem

Two contributors' vocabularies meet. One author writes critiques::[[X]]; another writes challenges::[[X]]. One calls a node a Predicate; another calls it a Relation Type. One's gardener serves the same role the other's content curator does. The overlap is real — both mean something in the neighborhood — and the distinction is also real: each term encodes a prior choice about what matters. Collapsing the two predicates into a canonical form erases the distinction; leaving them unlabeled in the graph hides the distinction from later readers who encounter one term without context for the other.

The default move is to rename to a canonical term. A reviewer suggests "use the standard one"; an agent summarizing the graph silently maps both to its preferred form; a curator consolidating the vocabulary list picks the term that appears more often. Each individual move is small, and the cumulative effect is convergence by precedent — the graph's vocabulary narrows without anyone explicitly deciding to narrow it.

The difficulty is recognition and discipline, not mechanics. Once the two terms are named as distinct, writing the Gloss is straightforward editorial work. The craft this Pattern teaches is noticing that the two terms are not interchangeable and intervening with translation before normalization becomes the path of least resistance.

Forces

Solution

When authoring, reviewing, or curating, watch for the moment two vocabularies meet. Trigger signals: a new contributor's predicate that overlaps with an existing one; a proposed rename from one term to another; a summarization pass that maps distinct predicates to the same canonical form; a review comment suggesting "use the standard term."

At the trigger, write a Gloss entry with this shape:

  1. Name each term as its own Gloss node, following the Gloss Form Contract's <Concept> -- <definition>.md filename shape. critiques -- engaged disagreement expecting response.md and challenges -- confrontation not assuming response.md as peers.
  2. Cite the tradition for each term in the body. A predicate's provenance — an adjacent plural-contributor corpus, a particular author's practice, a field's established usage — is part of what the term carries.
  3. Name the distinction each preserves. The load-bearing sentence names what the first term says that the second does not, and vice versa. The distinction may be axis ("engagement stance" vs "confrontation mode"), scope ("between two individuals" vs "to a group"), or register ("technical" vs "colloquial"). What matters is that the distinction is named explicitly, not implied.
  4. Cross-reference in Relations. Each Gloss carries contrasts_with:: to the other, with an annotation naming the load-bearing distinction.
  5. Leave both terms in the graph. The Gloss is the translation layer; the original authors' predicates stay in their nodes. Readers encounter the Gloss when they ask "what is the difference between these?"

Do not write the Gloss as a choice-of-vocabulary recommendation. The Gloss is a translation, not a vocabulary review — it does not recommend one term over the other, it makes both legible to readers and agents working across them.

Consequences

Instances

Also Known As

Relations