add training section with slide decks and explanations, CMEM-8382

.markdownlint.jsonc

@@ -20,6 +20,7 @@
       "div",
       "figcaption",
       "figure",
+      "iframe",
       "img",
       "key",
       "name",

Taskfile.yml

@@ -59,7 +59,7 @@ tasks:
       - poetry install
 
   check:
-    desc: Check documentation links, Markdown and YAML style, nav drift and build output
+    desc: Check documentation links, Markdown and YAML style, nav drift, Try it results and build output
     # Sequential (`cmds`, not `deps`) on purpose. Task resolves `deps` in
     # parallel, which ran several `poetry install` invocations at once and, worse,
     # ran `zensical build` alongside the link and style checks - under that load
@@ -71,6 +71,7 @@ tasks:
       - task: check:rumdl
       - task: check:yamllint
       - task: check:navigation
+      - task: check:try-results
       - task: check:output
 
   check:yamllint:
@@ -89,6 +90,13 @@ tasks:
     cmds:
       - poetry run dec-tool build-navigation --check
 
+  check:try-results:
+    desc: Fail if a "Try it" SPARQL box states a result its query no longer returns
+    deps:
+      - install
+    cmds:
+      - poetry run dec-tool update-try-results --check
+
   check:output:
     desc: Fail if a feature we reimplemented for Zensical regressed in the build
     deps:
@@ -313,6 +321,13 @@ tasks:
     cmds:
       - poetry run dec-tool build-navigation
 
+  update:try-results:
+    desc: Run the "Try it" SPARQL boxes and write their results into the pages
+    deps:
+      - install
+    cmds:
+      - poetry run dec-tool update-try-results
+
   public:versions:
     desc: List public documentation versions
     deps:

docs/.pages

@@ -8,5 +8,6 @@ nav:
     - Automate: automate
     - Develop: develop
     - Release Notes: release-notes
-    - Tutorials: tutorials
-
+    - Learn:
+          - Tutorials: tutorials
+          - Training: training