Skip to content

bitol-io/open-data-contract-standard

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenSSF Best Practices

Open Data Contract Standard (ODCS)

Welcome!

Thanks for your interest and for taking the time to come here! ❤️

Executive summary

This standard describes a structure for a data contract. Its current version is 2.2.1. It is available for you as an Apache 2.0 license. Contributions are welcome!

Discover the open standard

Discover the Open Data Contract Standard. This file contains some explanations and several examples. More examples have been added to v2.2.1.

What is a Data Contract?

The basics of a data contract

A data contract defines the agreement between a data producer and consumers. A data contract contains several sections:

  • Fundamentals.
  • Schema.
  • Data quality.
  • Service-level agreement (SLA).
  • Security & stakeholders.
  • Custom properties.

Data contract schema

Figure 1: illustration of a data contract, its principal contributors, sections, and usage.

JSON Schema

JSON Schema for ODCS can be found here. You can import this schema into your IDE for validation of your YAML files. The links below show how you can import the schema:

Contributing to the project

Check out the CONTRIBUTING file.

Articles

If you spot an article about the Open Data Contract Standard, make a pull request!

More

History

Formerly known as the data contract template, this standard is used to implement Data Mesh at PayPal. Starting with v2.2.0, it is maintained by a 501c6 non-profit organization called AIDA User Group (Artificial Intelligence, Data, and Analytics User Group). On November 30th, 2023, AIDA User Group and the Linux Foundation AI & Data joined forces to create Bitol. Bitol englobes ODCS and future standards & tools.

How does PayPal use Data Contracts?

PayPal uses data contracts in many ways, but this article from the PayPal Technology blog gives a good introduction.