Merge remote-tracking branch 'aida/dev' into dev-examples-fix-schema

# Conflicts:
#	CHANGELOG.md

Author: pflooky

CHANGELOG.md

@@ -10,12 +10,14 @@ This document tracks the history and evolution of the **Open Data Contract Stand
 * Update [examples](examples) to adhere to JSON schema
 * Full example from README directs to [full-example.yaml](examples/all/full-example.yaml)
 
-# v2.2.1 - 2023-10-03 - APPROVED
+# v2.2.1 - 2023-12-18 - APPROVED
 
-* Reformat Markdown tables
-* Reformat quality examples to be valid YAML
-* Add in isUnique, primaryKeyPosition, partitionKeyPosition and clusterKeyPosition to `column` definition
-* Add [JSON schema](schema/odcs-json-schema.json) to validate YAML files
+* Reformat quality examples to be valid YAML.
+* Type of definition for authority have standard values: `businessDefinition`, `transformationImplementation`, `videoTutorial`, `tutorial`, and `implementation`.
+* Add in `isUnique`, `primaryKeyPosition`, `partitionKeyPosition`, and `clusterKeyPosition` to `column` definition.
+* Add [JSON schema](schema/odcs-json-schema.json) to validate YAML files for v2.2.1.
+* Integrated as part of [Bitol](https://lfaidata.foundation/projects/bitol/).
+* Reformat Markdown tables.
 
 # v2.2.0 - 2023-07-27 - APPROVED
 
@@ -111,4 +113,4 @@ Removed the weight for system ratings from the data contract. Their default valu
   * Data quality.
 * System rating weightage.
 * Ratings:
-  * System, user, etc.
+  * System, user, etc.

README.md

@@ -1,14 +1,16 @@
-# Open Data Contract Standard
+[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/8149/badge)](https://www.bestpractices.dev/projects/8149)
+
+# 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**. It's current version is 2.2.0. It is available for you as an Apache 2.0 license. Contributions are welcome!
+This standard describes a structure for a **data contract**. It's 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](./docs/README.md). This file contains some explanations and several examples. More [examples](./examples/README.md) have been added to v2.2.
+Discover the [Open Data Contract Standard](./docs/README.md). This file contains some explanations and several examples. More [examples](./examples/README.md) have been added to v2.2.1.
 
 ## What is a Data Contract?
 
@@ -21,7 +23,7 @@ A data contract defines the agreement between a data producer and consumers. A d
 * Security & stakeholders.
 * Custom properties.
 
-![Data contract schema](./docs/img/data-contract-v2.2-schema.png "Data contract schema")
+![Data contract schema](./docs/img/data-contract-v2.2.1-schema.svg "Data contract schema")
 
 *Figure 1: illustration of a data contract, its principal contributors, sections, and usage.*
 
@@ -30,14 +32,16 @@ A data contract defines the agreement between a data producer and consumers. A d
 JSON Schema for ODCS can be found [here](schema/odcs-json-schema.json). You can import this schema into your IDE for 
 validation of your YAML files. Links below show how you can import the schema:
 
-- [Intellij](https://www.jetbrains.com/help/idea/json.html#ws_json_schema_add_custom)
-- [VSCode](https://code.visualstudio.com/docs/languages/json#_json-schemas-and-settings)
+- [IntelliJ](https://www.jetbrains.com/help/idea/json.html#ws_json_schema_add_custom)
+- [VS Code](https://code.visualstudio.com/docs/languages/json#_json-schemas-and-settings)
 
 ## Contributing to the project
 Check out the [CONTRIBUTING](./CONTRIBUTING.md) file.
 
 ## Articles 
-
+ * 2023-11-30 - [Linux Foundation AI & Data - Bitol Joins LF AI & Data as New Sandbox Project](https://lfaidata.foundation/blog/2023/11/30/bitol-joins-lf-ai-data-as-new-sandbox-project/)
+ * 2023-11-30 - [AIDAUG - Bitol Joins LF AI & Data as New Sandbox Project](https://aidausergroup.org/2023/11/30/bitol-joins-lf-ai-data-as-new-sandbox-project/)
+ * 2023-10-01 - [Data Contracts: A Bridge Connecting Two Worlds](https://medium.com/@atanas.iliev.ai/data-contracts-a-bridge-connecting-two-worlds-404eff1d970d)
  * 2023-09-10 - [Data Contracts 101](https://medium.com/p/568a9adbf9a9)
  * 2023-08-10 - [Welcome to the Open Data Contract Standard](https://jgp.ai/2023/08/09/welcome-to-the-open-data-contract-standard/)
  * 2023-05-11 - [Data Contracts – Everything You Need to Know](https://www.montecarlodata.com/blog-data-contracts-explained/)
@@ -51,7 +55,7 @@ If you spot an article about the Open Data Contract Standard, make a pull reques
 ## More
 
 ### History
-Formerly known as the data contract template, this standard is used to implement Data Mesh at [PayPal](https://about.pypl.com/). Today, 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).
+Formerly known as the data contract template, this standard is used to implement Data Mesh at [PayPal](https://about.pypl.com/). Today, 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](https://aidaug.org) and the [Linux Foundation AI & Data](https://lfaidata.foundation/) joined forces to create [Bitol](https://bitol.io). Bitol englobes ODCS and future standards & tools.
 
 ### How does PayPal use Data Contracts?
 PayPal uses data contracts in many ways, but this [article](https://medium.com/paypal-tech/the-next-generation-of-data-platforms-is-the-data-mesh-b7df4b825522) from the [PayPal Technology blog](https://medium.com/paypal-tech) gives a good introduction.

docs/README.md

@@ -143,7 +143,7 @@ dataset:
           - table_name_2
           - table_name_3
         transformLogic: sel t1.txn_dt as txn_ref_dt from table_name_1 as t1, table_name_2 as t2, table_name_3 as t3 where t1.txn_dt=date-3
-        transformDescription: defines the logic in business terms; logic for dummies
+        transformDescription: Defines the logic in business terms. 
         sampleValues:
           - 2022-10-03
           - 2020-01-28
@@ -225,11 +225,11 @@ dataset:
 
 ### Authorative definitions
 
-Updated in ODCS (Open Data Contract Standard) v2.3.0.
+Updated in ODCS (Open Data Contract Standard) v2.2.1.
 
 | Key  | UX label          | Required | Description                                                                                                                                                           |
 |------|-------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| type | Definition type   | Yes      | Type of definition for authority: v2.3 adds standard values: `businessDefinition`, `transformationImplementation`, `videoTutorial`, `tutorial`, and `implementation`. |
+| type | Definition type   | Yes      | Type of definition for authority: v2.2.1 adds standard values: `businessDefinition`, `transformationImplementation`, `videoTutorial`, `tutorial`, and `implementation`. |
 | url  | URL to definition | Yes      | URL to the authority.                                                                                                                                                 |
 
 ## Data quality