So You Want to Work With Data Contracts and Data Products?
Let’s be honest: data contracts and data products sound like something between legal paperwork and something you’d find in a warehouse. Let's change that.
However, in reality, they’re the backbone of modern data ecosystems. And once you understand how to create, version, evolve, and document them, you’ll never look at a CSV the same way again.
That’s why I created a short series of four hands-on tutorials to help you not just understand the concepts, but apply them. No buzzwords. No 50-slide decks. No BS. Just fundamental tools, APIs, YAML, curl, and progress. Note: Those tutorials are on Medium; I started them before I moved to Substack. Nevertheless, you can clap them there and like this article here.
The Four Tutorials at a Glance
Here’s the lifecycle you’ll walk through:
1. Experimenting with Data Contracts
We start with the basics: take some structured data (like a DDL schema) and create your first data contract based on the Open Data Contract Standard (ODCS). You’ll see how to validate, version, and store contracts — while realizing it’s easier than setting up your Wi-Fi printer (I just got one, so it's close to home).
Experiment like a pro with the tutorial and take the survey!
“Being able to quickly turn a database structure into a data contract has got me thinking how I can better document and describe my data.”
— Craig Petch
2. Playing with Data Products
Here, we introduce the Open Data Product Standard (ODPS) and build a data product from scratch using contracts as building blocks. Think LEGO, but for data. Note that this is relying on an older draft of the standard, and it is not yet compatible with Bitol ODPS v0.9.0.
Play like a pro with the tutorial and take the survey!
“[Bitol's] ODPS allows you to start tying together data contracts into cohesive deployment units.”
— Arne Laponin
3. Controlling Schema Drift
Everything changes — including your schema. This tutorial helps you detect what changed, how bad it is, and what version bump it deserves. No guesswork, no regrets.
Control like a pro with the tutorial and take the survey!
“This is going to change the way people look at managing data governance.”
— Alex Meadows
4. Making Pretty Documentation from Data Contracts
YAML is beautiful in its way, but not to everyone. Learn how to generate polished, human-friendly PDFs from your contracts. Yes, with logos. Yes, with a table of contents. Yes, with fewer headaches.
Publish like a pro with the tutorial and take the survey!
“This tool is wonderful for facilitating a transition to data contracts and getting people to stop relying on manual editing of Confluence.”
— Arne Laponin
Why This Matters
Data contracts and products aren’t just about structure — they’re about trust, reuse, and clarity.
With open standards like ODCS and ODPS, you’re not locked into a vendor. You’re building a shared language between producers and consumers.
By the end of this series, you’ll be able to:
Design contracts and products that actually work.
Manage change without chaos.
Automate documentation like a boss.
Get Started
The program is free and open to anyone. Knowledge of command-line tools, such as curl, is the only requirement. Check out the repository on GitHub. When you complete the four tutorials and surveys, you will earn a digital certificate that you can use to show your knowledge of data contract handling.
Support is done via the Data Mesh Community Slack. You can register here, and there is a specific channel to get help.
Conclusion
Working with data contracts and data products might sound intimidating at first, like a mash-up of bureaucracy and logistics. Still, once you dive in, it becomes something else entirely: empowering.
This hands-on series is your invitation to stop hand-waving about governance and start doing it. Whether you’re wrangling schemas, building reusable data assets, or just trying to make sense of what your data team promised last quarter, the combination of ODCS and ODPS gives you clarity, control, and confidence.
So don’t just read about modern data practices — experience them. Get your hands dirty, play with real tools, and come out the other side ready to build trust into your data pipeline from the start.
The warehouse is open. Your contract is ready. Let’s build some products.
Love this, Jean-Georges, thank you!
A note for those not familiar with the clapping system on Medium: a clap is not the same as a like on other platforms. In fact, it's considered rude and insulting to give one article just one clap. Go for the max, 50, JG's works deserves it!