Improve docs coverage and validation

.github/styles/config/vocabularies/embucket/accept.txt

@@ -33,3 +33,18 @@ NYC
 UTC
 DBAs?
 config
+repo
+repos
+serverless
+toolchain
+Makefile
+walkthrough
+rollout
+charset
+env
+hardcoded
+hardcode
+unpatched
+deployer
+anonymized
+bootable

.github/workflows/docs-ci.yml

@@ -5,10 +5,12 @@ on:
     branches: [main]
     paths:
       - "docs/**"
+      - ".github/workflows/docs-ci.yml"
   pull_request:
     branches: [main]
     paths:
       - "docs/**"
+      - ".github/workflows/docs-ci.yml"
 
 # Cancel in-progress runs for the same branch/PR to save resources
 concurrency:
@@ -49,10 +51,47 @@ jobs:
         working-directory: ./docs
         run: pnpm prettier --check . 
 
+  smoke:
+    name: Docs Smoke Checks
+    runs-on: ubuntu-latest
+    needs: [format]
+    steps:
+      - uses: actions/checkout@v6
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: "22"
+      - name: Setup PNPM
+        uses: pnpm/action-setup@v4
+        with:
+          version: "10.11.0"
+          run_install: false
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        shell: bash
+        run: |
+          echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
+      - name: Setup pnpm cache
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/docs/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+      - name: Install dependencies
+        working-directory: ./docs
+        run: pnpm install
+      - name: Run Astro check
+        working-directory: ./docs
+        run: pnpm check
+      - name: Run docs smoke checks
+        working-directory: ./docs
+        run: pnpm smoke
+
   build:
     name: Validate Build
     runs-on: ubuntu-latest
-    needs: [format]
+    needs: [format, smoke]
     steps:
       - uses: actions/checkout@v6
       - name: Setup Node.js
@@ -81,13 +120,15 @@ jobs:
         run: pnpm install
       - name: Validate build
         working-directory: ./docs
-        run: pnpm build:dry-run
+        run: pnpm build
 
   vale-lint:
     name: Vale lint
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6
       - uses: errata-ai/vale-action@v2.1.1
+        continue-on-error: true
         with:
           files: "docs/src/content/"
+          reporter: github-check