Validate versioned documentation structure

Author: jaavid

.github/workflows/documentation.yml

@@ -0,0 +1,28 @@
+name: Documentation CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Validate versioned information architecture
+        shell: bash
+        run: |
+          set -euo pipefail
+          test -s README.md
+          test -s docs/README.md
+          test -s docs/v1/README.md
+          grep -Fq '1.0.0-draft' docs/v1/README.md
+          grep -Fq 'corelink_device_id' docs/v1/README.md
+          if grep -Fq 'API contract repository also has unpopulated' README.md; then
+            echo "stale API-contract status returned" >&2
+            exit 1
+          fi