Language matters: The power of ubiquitous language

How ubiquitous language can improve your software development experience

Sat Jul 08 2023

I’m not talking about programming languages here (although some languages have features that support domain-driven design better than others). I’m talking about the power of ubiquitous language.

In the world of software development, effective communication is paramount. Miscommunication can lead to misunderstandings, bugs, and ultimately, a software product that falls short of meeting users' needs. That's where ubiquitous language comes - a language that spreads to every corner of your software development process.

But what exactly is ubiquitous language? Think of it as a bridge that connects developers, domain experts, and stakeholders, enabling seamless and meaningful conversations about the software's purpose, features, and behaviour. Ubiquitous language is a common vocabulary or terminology that everyone can understand and use to discuss the domain-specific concepts and processes.

Imagine you're building a new e-commerce platform. You’re using technical jargon like "data transfer object" or "entity" in your code, then trying to communicate with non-technical people around that. It usually goes one of two ways - you start using that technical jargon with them and they have no idea what you’re talking about, or you try to translate the concepts you think about as a developer into concepts the person you’re talking to understands. This is very challenging, a huge cognitive load and from my experience always leads to miscommunication.

Ubiquitous language encourages you to speak the language of the business domain. Talk about "products," "customers," and "orders" instead of technical jargon. Talk about "add to cart" rather than "create basket item", or "checkout" rather than "create order". Learn about the domain concepts and what they mean. By aligning the language you use with the stakeholders and domain experts, you're fostering a shared understanding that can shape the software's design and behaviour more accurately.

But the power of ubiquitous language goes beyond communication. It influences the structure of your software. By using domain-specific terminology consistently in your code, you create a codebase that reflects the language of the business, making it easier to maintain, extend, and reason about. With this approach, your code reads in a way that’s easy to speak about with other people in the business.

Now, this doesn't mean that ubiquitous language is a silver bullet that instantly solves all communication and software development challenges. It requires effort, collaboration, and a genuine desire to understand the domain deeply. It demands active participation from developers and domain experts alike, continuously refining and evolving the shared language as the understanding grows.

Remember, language matters. Create software that speaks the language of the business, avoiding technical jargon and promoting a deeper understanding of the domain. In the realm of software development, ubiquitous language is the secret ingredient that unlocks the potential for building high-quality, domain-aligned software solutions.

How to build software that just makes sense

Battling with complex business logic and spaghetti code?

Struggling to communicate in software teams?

Discovering Domain-Driven Design is the only resource you'll need for a distilled overview of domain-driven design and how you can use it to build better software.

Discovering Domain-Driven Design ebook cover