liveBook · Manning

Ubiquitous language

As explained in The Well-Grounded Data Analyst

Business terminology is the agreed meanings of domain-specific terms used by people involved in an analysis.

Ubiquitous language is the shared set of agreed meanings for domain-specific terms used by analysts and stakeholders. It turns vague questions into defined terminology, scope, and reproducible analytical decisions. section 1.2.1

When “yesterday” is not precise

A stakeholder asks how much the business sold yesterday. Clarify whether “yesterday” uses the order date, payment date, or dispute-resolution date, and whether a later return changes what “sold” means. Record the agreed definitions before analyzing the data. section 1.2.1

Build shared terminology through practical decisions:

  • Ask stakeholders to define ambiguous entities such as “customer,” including whether the term means a person, an organization, or both. section 3.1.1
  • Agree on the scope and meanings needed for the analysis, then document them for transparency and reproducibility. section 1.2.1
  • Encode the resulting business entities, concepts, and activities in a data model instead of redefining them for every analysis. section 3.1.1

How The Well-Grounded Data Analyst covers it

How deep it goes
Defines terms through stakeholder discussion and documentation, then encodes them in data models; it stops short of prescribing a universal vocabulary.
Examples
Uses ambiguous dates, sales and returns, customer identity, and business metrics to expose competing meanings.
What it assumes
Requires stakeholder collaboration and basic familiarity with analytical questions, while treating domain definitions as decisions to establish rather than assumptions.
What you can do after
Apply agreed terminology to frame measurable questions, document assumptions, and create more consistent analytical data models.
How it connects
Connects requirements clarification, data modeling, business metrics, data quality, and analytical reproducibility.

Also explained in

Compare how 4 books explain ubiquitous language →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of The Well-Grounded Data Analyst. The section links point to the parts of the book it draws on.