terminology rule
terminology.confusable-context
Use a known Canon term only for the semantic kind and scope established by its authored relationships and the surrounding construct.
- product: error
- marketing: error
- public: warning
- docs: warning
Rationale
A confusable spelling can name a valid Canon entity while still being wrong for an explicit capacity, domain, harmony, composition, or Formation scope. Canon relationships identify the alternative without embedding vocabulary in detector code.
Guidance
Follow the related stable Canon identity and its notation as correction evidence, then choose wording only after confirming the intended meaning.
Checker behavior
Message
{captured} is not valid in this Canon context.
Applies in
- heading
- body
- blockquote
- list item
- table cell
- json key
- glossary term
- notation token
Detection
- kind
- term
- relations
- confusable_with
Authored examples and fix policies
- subtypes
[ { "examples": { "correct": [ { "check_input": { "kind": "document" }, "format": "text", "id": "communication-harmony", "profile": "general-prose", "surface": "docs", "text": "the Communication harmony" }, { "check_input": { "kind": "document" }, "format": "text", "id": "communication-bare", "profile": "general-prose", "surface": "docs", "text": "Communication" }, { "check_input": { "kind": "document" }, "format": "text", "id": "communication-sentence-start", "profile": "general-prose", "surface": "docs", "text": "Communication matters." }, { "check_input": { "kind": "document" }, "format": "text", "id": "communication-lowercase-prose", "profile": "general-prose", "surface": "docs", "text": "communication channel" }, { "check_input": { "kind": "document" }, "format": "text", "id": "move-ordinary-verb", "profile": "general-prose", "surface": "docs", "text": "Move client" }, { "check_input": { "kind": "document" }, "format": "text", "id": "open-ordinary-verb", "profile": "general-prose", "surface": "docs", "text": "Open with the file" }, { "check_input": { "kind": "document" }, "format": "text", "id": "open-harmony-context", "profile": "general-prose", "surface": "docs", "text": "Open × Emotional" }, { "check_input": { "kind": "document" }, "format": "text", "id": "move-domain-context", "profile": "general-prose", "surface": "docs", "text": "Move in the Relational Domain" }, { "check_input": { "kind": "document" }, "format": "markdown", "id": "communication-heading", "profile": "general-prose", "surface": "docs", "text": "# Communication" }, { "check_input": { "kind": "document" }, "format": "markdown", "id": "communication-list-start", "profile": "general-prose", "surface": "docs", "text": "* Communication" }, { "check_input": { "kind": "document" }, "format": "markdown", "id": "communication-blockquote-start", "profile": "general-prose", "surface": "docs", "text": "> Communication" }, { "check_input": { "kind": "document" }, "format": "markdown", "id": "communication-table-start", "profile": "general-prose", "surface": "docs", "text": "| Communication |\n| --- |" }, { "check_input": { "kind": "document" }, "format": "text", "id": "communication-title-case-run", "profile": "general-prose", "surface": "docs", "text": "Communication Strategy" }, { "check_input": { "kind": "document" }, "format": "text", "id": "unrelated-proper-noun", "profile": "general-prose", "surface": "docs", "text": "The project belongs to May." }, { "check_input": { "expectation": { "expected_kinds": [ "axis" ], "kind": "entry" }, "kind": "typed-value", "node": "glossary_term" }, "format": "text", "id": "typed-move-as-axis", "profile": "general-prose", "surface": "docs", "text": "Move" } ], "incorrect": [ { "captured": "Communication", "check_input": { "kind": "document" }, "format": "text", "id": "communication-as-capacity", "outcome_id": "violation", "profile": "general-prose", "surface": "docs", "text": "the Communication capacity" }, { "captured": "Communication", "check_input": { "expectation": { "expected_kinds": [ "axis" ], "kind": "entry" }, "kind": "typed-value", "node": "glossary_term" }, "format": "text", "id": "typed-harmony-as-axis", "outcome_id": "violation", "profile": "general-prose", "surface": "docs", "text": "Communication" } ] }, "id": "wrong-kind", "outcomes": [ { "disposition": "structural", "fix": { "interactive": "suggest", "unattended": "retry" }, "id": "violation" } ], "supersedes": [] }, { "examples": { "correct": [ { "check_input": { "expectation": { "bound_operands": [ { "operand_index": 1, "target_id": "formation.single.axis.capacity" }, { "operand_index": 2, "target_id": "formation.single.state.under" } ], "composition_id": "compose.single-formation", "kind": "composition-operand", "operand_index": 0 }, "kind": "typed-value", "node": "notation_token" }, "format": "text", "id": "single-family-in-single-scope", "profile": "general-prose", "surface": "docs", "text": "formation.single.family.level" } ], "incorrect": [ { "captured": "formation.dyad.family.level", "check_input": { "expectation": { "bound_operands": [ { "operand_index": 1, "target_id": "formation.single.axis.capacity" }, { "operand_index": 2, "target_id": "formation.single.state.under" } ], "composition_id": "compose.single-formation", "kind": "composition-operand", "operand_index": 0 }, "kind": "typed-value", "node": "notation_token" }, "format": "text", "id": "dyad-family-in-single-scope", "outcome_id": "violation", "profile": "general-prose", "surface": "docs", "text": "formation.dyad.family.level" } ] }, "id": "wrong-scope", "outcomes": [ { "disposition": "structural", "fix": { "interactive": "suggest", "unattended": "retry" }, "id": "violation" } ], "supersedes": [] } ]