Add getting started annex

Adds an Annex that walks through writing a JSON-LD SPDX document line by
line

Signed-off-by: Joshua Watt <[email protected]>

Author: JPEWdev

.github/workflows/validate_examples.yml

@@ -7,9 +7,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@f43a0e5ff2bd294095638e18286ca9a3d1956744 # v3
-      - name: Install dependencies
+      - name: Install python dependencies
         run: |
           python3 -m pip install pyshacl==0.25.0 check-jsonschema==0.28.1
+      - name: Install dependencies
+        run: |
+          sudo apt install -y gawk
       - name: Check files
         run: |
           set -e
@@ -27,3 +30,18 @@ jobs:
               $f
           done
 
+      - name: Check documentation examples
+        run: |
+          for f in $(grep -l '```json' docs/annexes/*.md); do
+            echo "Checking $f"
+            cat $f | awk '/^```json/, $0=="```" {if ($0 !~ /^```.*/ ) print}' > temp.json
+            check-jsonschema \
+              -v \
+              --schemafile https://spdx.org/schema/3.0.0/spdx-json-schema.json \
+              temp.json
+
+            pyshacl \
+              -s https://spdx.org/rdf/3.0.0/spdx-model.ttl \
+              -e https://spdx.org/rdf/3.0.0/spdx-model.ttl \
+              temp.json
+          done