Problem
Broken links in the website docs are only caught when Docusaurus builds in production. PR #548 merged with stale links to remediation-strategy.md that caused the production build to fail and required a follow-up hotfix (#549).
Solution
Add a CI step that runs npm run build in the website/ directory whenever docs files change. This catches broken links, missing files, and MDX syntax errors before they reach main.
Suggested implementation
Add a job to .github/workflows/ci.yml that:
- Runs only when
website/** files change (path filter)
- Installs website dependencies (
npm ci in website/)
- Runs
npm run build in website/
- Fails the PR if the build fails
Problem
Broken links in the website docs are only caught when Docusaurus builds in production. PR #548 merged with stale links to
remediation-strategy.mdthat caused the production build to fail and required a follow-up hotfix (#549).Solution
Add a CI step that runs
npm run buildin thewebsite/directory whenever docs files change. This catches broken links, missing files, and MDX syntax errors before they reach main.Suggested implementation
Add a job to
.github/workflows/ci.ymlthat:website/**files change (path filter)npm ciinwebsite/)npm run buildinwebsite/