Merge pull request #260 from Programcode/seo/plain-guides

Rewrite the generic debate guides in plain language

Author: Programcode

docs/testing.md

@@ -154,14 +154,15 @@ npm run verify
 The gate runs, in order:
 
 1. documentation checks
-2. lint
-3. type checking
-4. unit tests
-5. collaboration service tests
-6. native Edge Function tests
-7. production build
-8. production service-worker offline smoke
-9. the desktop Chromium `@smoke` set (`npm run verify:full` adds the full desktop and mobile suite)
+2. the guide jargon check (`npm run seo:jargon`): no generated guide in `public/` other than `/lincoln-douglas-debate` and `/policy-debate` may use framework, contention, warrant or impact calculus more than once in its visible text or its JSON-LD ([`scripts/check_jargon.py`](../scripts/check_jargon.py))
+3. lint
+4. type checking
+5. unit tests
+6. collaboration service tests
+7. native Edge Function tests
+8. production build
+9. production service-worker offline smoke
+10. the desktop Chromium `@smoke` set (`npm run verify:full` adds the full desktop and mobile suite)
 
 It does not start local Supabase, run pgTAP, run WebKit, or use protected staging.
 

package.json

@@ -23,6 +23,7 @@
     "preview": "vite preview",
     "smoke:jev": "node scripts/smoke-jev.mjs",
     "seo:indexnow": "python3 scripts/indexnow_submit.py",
+    "seo:jargon": "python3 scripts/check_jargon.py --max 1",
     "test": "vitest run",
     "test:collaboration": "vitest run --config services/collaboration/vitest.config.ts",
     "start:collaboration": "tsx services/collaboration/src/index.ts",
@@ -35,7 +36,7 @@
     "test:sw": "node scripts/test-service-worker-offline.mjs",
     "test:e2e:staging": "playwright test --project=staging",
     "test:agentic": "bash .claude/skills/verify-debatelab/bin/verify.sh e2e run",
-    "verify": "npm run docs:check && npm run lint && npm run typecheck && npm test && npm run test:collaboration && npm run test:edge && npm run build && npm run test:sw && P=$(bash .superset/e2e-port.sh) && CI=1 PORT=$P PLAYWRIGHT_BASE_URL=http://127.0.0.1:$P npm run test:e2e:smoke",
+    "verify": "npm run docs:check && npm run seo:jargon && npm run lint && npm run typecheck && npm test && npm run test:collaboration && npm run test:edge && npm run build && npm run test:sw && P=$(bash .superset/e2e-port.sh) && CI=1 PORT=$P PLAYWRIGHT_BASE_URL=http://127.0.0.1:$P npm run test:e2e:smoke",
     "verify:full": "npm run verify && P=$(bash .superset/e2e-port.sh) && CI=1 PORT=$P PLAYWRIGHT_BASE_URL=http://127.0.0.1:$P npm run test:e2e"
   },
   "dependencies": {