Ubiquitous Language

Kind: activity

Layer: Contracts Core

Record: architecture:ubiquitous-language

Severity: recommended

Scope: bounded context, domain, codebase

Canonical: Ontology

The practice of using the domain's own terms, agreed with its experts, in conversation, documentation and code alike.

Listed in Architecture principles, after Semantic Consistency and before Intent-Revealing Interface.

Requires

• Domain Collaboration

Reinforces

• Domain-Driven Design (DDD)
• Semantic Contracts

Enables

• Intent-Revealing Interface

Conflicts with

• Technical/Domain Mismatch

In tension with

• Cross-Context Terminology

Tensions

• Ubiquitous Language / Cross-Context Terminology

Violated by

• Technical/Domain Mismatch

Refactored by

• Name the Concept

Severity

• recommended

Category

• Schema / Canonical Data / Semantics

Required by

• Domain Model
• Bounded Context
• Canonical Model
• Semantic Consistency

Reinforced by

• Domain Service
• Domain-Specific Language
• Closed Vocabulary

Linked from

• Why it works
• Rules with names
• Domain Architecture
• Contracts / Interfaces / Compatibility
• Metaprogramming / Language-Oriented Architecture
• Schema / Canonical Data / Semantics
• Taxonomy / Classification / Naming
• Core Vocabulary
• Schema / Canonical Data / Semantics
• Severity levels
• The resolutions