naming of examples and some clean ups

ogcincubator · Oct 28, 2024 · 8ea4432 · 8ea4432
1 parent a4d6d64
commit 8ea4432
Show file tree

Hide file tree

Showing 23 changed files with 27 additions and 140 deletions.
diff --git a/_sources/exercise0/examples.yaml b/_sources/exercise0/examples.yaml
@@ -4,7 +4,7 @@ $schema: https://raw.githubusercontent.com/opengeospatial/bblocks-postprocess/re
 examples:
 - title: Reference a local file for examples
   content: |-
-    [Example from mySchema](../../exercise1/example.json)
+    [Example from Exercise  1](/bblock/ogc.bbr.tutorial.exercise1/example)
     
     In **Markdown** format.
 

diff --git a/_sources/exercise1/examples.yaml b/_sources/exercise1/examples.yaml
@@ -4,7 +4,7 @@ $schema: https://raw.githubusercontent.com/opengeospatial/bblocks-postprocess/re
 examples:
 - title: Reference a local file for examples
   content: |-
-    [Example from mySchema](../../exercise1/example.json)
+    [Example from Exercise  1](/bblock/ogc.bbr.tutorial.exercise1/example)
     
     In **Markdown** format.
 

diff --git a/_sources/exercise2/bblock.json b/_sources/exercise2/bblock.json
@@ -1,8 +1,8 @@
 {
   "$schema": "metaschema.yaml",
-  "name": "Exercise 2",
+  "name": "2 - Add a JSON-LD context",
   "highlighted": true,
-  "abstract": "Add a JSON-LD context",
+  "abstract": "Semantically annotate a schema by adding a simple JSON-LD context",
   "status": "under-development",
   "dateTimeAddition": "2023-04-05T00:00:00Z",
   "itemClass": "schema",

diff --git a/_sources/exercise2/examples.yaml b/_sources/exercise2/examples.yaml
@@ -6,7 +6,7 @@ $schema: https://raw.githubusercontent.com/opengeospatial/bblocks-postprocess/re
 examples:
 - title: Reference a local file for examples
   content: |-
-    [Example from mySchema](../../exercise1/example.json)
+    [Example from Exercise  1](/bblock/ogc.bbr.tutorial.exercise1/example)
     
     In **Markdown** format.
 

diff --git a/_sources/exercise3/bblock.json b/_sources/exercise3/bblock.json
@@ -1,8 +1,8 @@
 {
   "$schema": "metaschema.yaml",
-  "name": "Exercise 3",
+  "name": "3 - Add Semantic Rules",
   "highlighted": true,
-  "abstract": "Add logical rules",
+  "abstract": "Add logical rules using SHACL to exploit semantic annotations",
   "status": "under-development",
   "dateTimeAddition": "2023-04-05T00:00:00Z",
   "itemClass": "model",

diff --git a/_sources/exercise3/description.md b/_sources/exercise3/description.md
@@ -1,6 +1,8 @@
 ## Exercise 3
 
-Goal: Validate logical rules
+Goal: Define logical rules to exploit semantic annotation
+
+This will be a basic example that uses the JSON-LD bindings and simple rules.  Note that richer rules can be defined that use referenced semantic models and advanced reasoning, however significant extra functionality is provided simply by being able to identify and operate on schema elements with richer logic languages like SHACL.
 
 ### Steps
 - uncomment line 11 in `rules.shacl` 

diff --git a/_sources/exercise3/examples.yaml b/_sources/exercise3/examples.yaml
@@ -6,7 +6,7 @@ prefixes:
 examples:
 - title: Reference a local file for examples
   content: |-
-    [Example from mySchema](../../exercise1/example.json)
+    [Example from Exercise  1](/bblock/ogc.bbr.tutorial.exercise1/example)
     
     In **Markdown** format.
 

diff --git a/_sources/exercise4/bblock.json b/_sources/exercise4/bblock.json
@@ -1,8 +1,8 @@
 {
   "$schema": "metaschema.yaml",
-  "name": "Exercise 4",
+  "name": "4 - Profile a BB (using rules)",
   "highlighted": true,
-  "abstract": "Profile with rules",
+  "abstract": "Profile another Building Block with additional constraint rules",
   "status": "under-development",
   "dateTimeAddition": "2023-04-05T00:00:00Z",
   "itemClass": "model",

diff --git a/_sources/exercise5/bblock.json b/_sources/exercise5/bblock.json
@@ -1,5 +1,5 @@
 {
-  "name": "Exercise 5",
+  "name": "5 - Features",
   "abstract": "This example shows a simple customisation for OGC API Feature schemas",
   "status": "under-development",
   "dateTimeAddition": "2023-05-19T00:00:00Z",

diff --git a/_sources/exercise6/bblock.json b/_sources/exercise6/bblock.json
@@ -1,6 +1,6 @@
 {
-  "name": "Exercise 6",
-  "abstract": "Profiling an external bblock",
+  "name": "6 - Import and extend",
+  "abstract": "Profiling a BBlock from another register",
   "status": "under-development",
   "dateTimeAddition": "2023-05-19T00:00:00Z",
   "itemClass": "schema",

diff --git a/_sources/exercise7/bblock.json b/_sources/exercise7/bblock.json
@@ -1,5 +1,5 @@
 {
-  "name": "Exercise 7",
+  "name": "7 - Transforms",
   "abstract": "schema and graph transforms",
   "status": "under-development",
   "dateTimeAddition": "2024-10-03T11:31:00+02:00",

diff --git a/_sources/exercise8/bblock.json b/_sources/exercise8/bblock.json
@@ -1,11 +1,18 @@
 {
-  "name": "Exercise 8",
-  "abstract": "Transform from CityJSON to TopoFeature",
+  "name": "8 - Advanced Transform Example",
+  "highlighted": true,
+  "abstract": "This example highlights an advanced transform from CityJSON to TopoFeature, showing a range of features interacting to support this complex task.",
   "status": "under-development",
   "dateTimeAddition": "2024-10-18T08:31:00Z",
   "itemClass": "schema",
   "register": "building-blocks-tutorial",
   "version": "0.1",
   "dateOfLastChange": "2024-10-18",
-  "tags": ["building-blocks-tutorial", "3D", "geometry", "topology", "cityjson"]
+  "tags": [
+    "building-blocks-tutorial",
+    "3D",
+    "geometry",
+    "topology",
+    "cityjson"
+  ]
 }
diff --git a/_sources/mySchema/assets/README.md b/_sources/mySchema/assets/README.md
diff --git a/_sources/mySchema/assets/example.png b/_sources/mySchema/assets/example.png
diff --git a/_sources/mySchema/bblock.json b/_sources/mySchema/bblock.json
diff --git a/_sources/mySchema/context.jsonld b/_sources/mySchema/context.jsonld
diff --git a/_sources/mySchema/description.md b/_sources/mySchema/description.md
diff --git a/_sources/mySchema/example.json b/_sources/mySchema/example.json
diff --git a/_sources/mySchema/examples.yaml b/_sources/mySchema/examples.yaml
diff --git a/_sources/mySchema/rules.shacl b/_sources/mySchema/rules.shacl
diff --git a/_sources/mySchema/schema.yaml b/_sources/mySchema/schema.yaml
diff --git a/_sources/mySchema/tests.yaml b/_sources/mySchema/tests.yaml
diff --git a/_sources/mySchema/tests/rules-fail.json b/_sources/mySchema/tests/rules-fail.json