Skip to content

Commit

Permalink
Merge pull request #50 from pflooky/docs-fix-links
Browse files Browse the repository at this point in the history
  • Loading branch information
jgperrin authored May 24, 2024
2 parents ef07ba9 + 3b03a5f commit 25a0698
Show file tree
Hide file tree
Showing 3 changed files with 7 additions and 7 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/docs-site-deploy.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ jobs:
mkdocs-material-
- run: pip install mkdocs-open-in-new-tab mike
- run: pip install mkdocs-material
- run: cp README.md docs/index.md
- run: cat README.md | sed 's/docs\///g' | sed 's/CONTRIBUTING.md/contributing.md/g' > docs/index.md
- run: cat CHANGELOG.md | sed 's/docs\///g' > docs/changelog.md
- run: cp CONTRIBUTING.md docs/contributing.md
- run: cp CHANGELOG.md docs/changelog.md
- run: mike deploy --push --update-aliases ${{ github.ref_name }} latest
2 changes: 1 addition & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ This document tracks the history and evolution of the **Open Data Contract Stand
* 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.
* Add [JSON schema](https://github.com/bitol-io/open-data-contract-standard/blob/main/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.

Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Thanks for your interest and for taking the time to come here! ❤️
This standard describes a structure for a **data contract**. It's current version is v2.2.2. 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/index.md). This file contains some explanations and several examples. More [examples](docs/examples/index.md) can be found here.
Discover the [Open Data Contract Standard](docs/standard.md). This file contains some explanations and several examples. More [examples](docs/examples/index.md) can be found here.

## What is a Data Contract?

Expand All @@ -23,13 +23,13 @@ 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.1-schema.svg "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.*

### JSON Schema

JSON Schema for ODCS can be found [here](schema/odcs-json-schema.json). You can import this schema into your IDE for
JSON Schema for ODCS can be found [here](https://github.com/bitol-io/open-data-contract-standard/blob/main/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)
Expand Down Expand Up @@ -82,7 +82,7 @@ mike set-default --push latest #by default, users will go to
```

#### Deploying a new version
Given that the Github action [here](.github/workflows/docs-site-deploy.yaml) it set to trigger when a new tag version is
Given that the Github action [here](https://github.com/bitol-io/open-data-contract-standard/blob/main/.github/workflows/docs-site-deploy.yaml) it set to trigger when a new tag version is
created, all that is required is to:
1. [Create a new release](https://github.com/bitol-io/open-data-contract-standard/releases)
2. Put in new tag version for release (follows pattern v*)
Expand Down

0 comments on commit 25a0698

Please sign in to comment.