Company
Data Contracts: Our Article on martinfowler.com
Today martinfowler.com published Data Contracts, a long-form article by Simon Harrer (co-founder and CEO of Entropy Data) and Arif Wider (professor of software engineering at HTW Berlin), edited by Martin Fowler.
martinfowler.com is where many software engineers first read about continuous integration, microservices, and data mesh. We are proud that data contracts now have an in-depth article there too.
What the article covers
The article treats data contracts as API design for data: a machine-readable, versioned description of the contents and guarantees of a dataset, owned by the data producer and written with its consumers in mind. It walks through:
- Why we need data contracts, and why AI agents need them even more, since they otherwise have to guess what data means.
- What goes into a data contract: schema, data quality, ownership, terms of use, SLAs, roles, AI context, and pricing, based on the Open Data Contract Standard (ODCS).
- Data contracts in context: how they link to ontologies, how data products build on them, and why they are the product details page in a data marketplace.
- Working with data contracts: data-first or contract-first, Git, versioning and breaking changes, and testing in CI/CD with the open-source Data Contract CLI.
- Costs and benefits: what you gain, what it costs, and why you should not roll out data contracts everywhere at once.
A data contract is a structured document, typically YAML, not prose buried in a wiki.
Why we wrote it
Almost every customer conversation raises the same questions about data contracts: What belongs in a contract? Who owns it? How do we version it? Do we still need one now that we have AI? The article answers them in one place, independent of any vendor. And it argues for open standards, so your metadata stays portable whichever tools you choose.
Thank you to Martin Fowler for editing the article, and to everyone who reviewed the drafts.
Read the article
The article is free to read on martinfowler.com. For a shorter introduction, start with our explainer What is a Data Contract?