From 3301ccf21ad9a875c93e6f088a89411aaa401eed Mon Sep 17 00:00:00 2001
From: Flook Peter <pflooky@hotmail.com>
Date: Tue, 30 Jul 2024 08:26:49 +0800
Subject: [PATCH 1/2] Update markdown files in docs folder to use README file
 name, add in README for script folder

---
 docs/{standard.md => README.md}       | 0
 docs/examples/{index.md => README.md} | 0
 mkdocs.yml                            | 4 ++--
 script/README.md                      | 9 +++++++++
 4 files changed, 11 insertions(+), 2 deletions(-)
 rename docs/{standard.md => README.md} (100%)
 rename docs/examples/{index.md => README.md} (100%)
 create mode 100644 script/README.md

diff --git a/docs/standard.md b/docs/README.md
similarity index 100%
rename from docs/standard.md
rename to docs/README.md
diff --git a/docs/examples/index.md b/docs/examples/README.md
similarity index 100%
rename from docs/examples/index.md
rename to docs/examples/README.md
diff --git a/mkdocs.yml b/mkdocs.yml
index 4a5366c..b4f6ab3 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -33,8 +33,8 @@ theme:
 
 nav:
   - Home: 'index.md'
-  - Standard: 'standard.md'
-  - Examples: 'examples/index.md'
+  - Standard: 'README.md'
+  - Examples: 'examples/README.md'
   - Changelog: 'changelog.md'
   - Contributing: 'contributing.md'
   - Vendors: 'vendors.md'
diff --git a/script/README.md b/script/README.md
new file mode 100644
index 0000000..1cd84e8
--- /dev/null
+++ b/script/README.md
@@ -0,0 +1,9 @@
+# Script
+
+## Building docs
+
+The script [`build_docs.sh`](build_docs.sh) is used to help move some top level markdown files into the 
+[`docs`](../docs) directory to allow for mkdocs to create a website based on the markdown files.
+
+This script gets called via the [GitHub Action](../.github/workflows/docs-site-deploy.yaml) that will build and deploy 
+the documentation website.

From 5d97c0ae08dbe1d0cd63f9f9fca756ae49137a51 Mon Sep 17 00:00:00 2001
From: Flook Peter <pflooky@hotmail.com>
Date: Tue, 30 Jul 2024 08:46:58 +0800
Subject: [PATCH 2/2] Fix links in top level README

---
 README.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index eb02b07..85b78db 100644
--- a/README.md
+++ b/README.md
@@ -18,19 +18,19 @@ This standard describes a structure for a **data contract**. Its current version
 ## Discover the open standard
 A reader-friendly version of the standard can be found on its [dedicated site](https://bitol-io.github.io/open-data-contract-standard/).
 
-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.
+Discover the [Open Data Contract Standard](docs/README.md). This file contains some explanations and several examples. More [examples](docs/examples/README.md) can be found here.
 
 ## 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](docs/standard.md#demographics).
-* [Schema](docs/standard.md#dataset-and-schema).
-* [Data quality](docs/standard.md#data-quality).
-* [Service-level agreement (SLA)](docs/standard.md#service-level-agreement).
-* [Security & stakeholders](docs/standard.md#stakeholders).
-* [Custom properties](docs/standard.md#other-properties).
+* [Fundamentals](docs/README.md#demographics).
+* [Schema](docs/README.md#dataset-and-schema).
+* [Data quality](docs/README.md#data-quality-).
+* [Service-level agreement (SLA)](docs/README.md#service-level-agreement).
+* [Security & stakeholders](docs/README.md#stakeholders).
+* [Custom properties](docs/README.md#other-properties).
 
 ![Data contract schema](docs/img/data-contract-v2.2.1-schema.svg "Data contract schema")