fix: Update deployment workflow to build Docusaurus docs

[ibrahimcesar]

Summary

Updates the GitHub Pages deployment workflow to build and deploy the new Docusaurus documentation site instead of the old standalone demo that was removed.

Changes

Deployment Workflow Updates

• Renamed workflow: "Deploy Demo to GitHub Pages" → "Deploy Docs to GitHub Pages"
• Updated build process: Now builds docs from docs/ directory instead of demo/
• Changed artifact path: demo/out → docs/build
• Added automatic trigger: Deploys on pushes to main that affect docs/** or the workflow file
• Removed version input: Simplified workflow dispatch since docs always use local library build
• Updated npm cache: Now caches docs/package-lock.json
• Updated messaging: All deployment summaries now reference documentation instead of demo

GNU Terry Pratchett Tribute

• Added X-Clacks-Overhead: GNU Terry Pratchett header to all documentation pages
• Created custom Docusaurus plugin to inject the meta tag
• "A man is not dead while his name is still spoken." - Read more: http://www.gnuterrypratchett.com/

Context

The standalone Next.js demo was replaced with a comprehensive Docusaurus documentation site in recent PRs. The deployment workflow was still trying to build the old demo structure, which no longer exists.

Testing

• ✅ Workflow syntax is valid
• ✅ All paths reference existing directories
• ✅ npm cache configuration points to correct lock file
• ✅ Docs build successfully with new plugin
• ✅ X-Clacks-Overhead header verified in built HTML

Related

• Original demo refactor: Refactor/extract demo components to modules #219
• Docs site creation and updates

---

Ready to merge - This fixes the broken deployment workflow and adds a tribute header.

[github-actions]

size-limit report 📦

Path	Size
ES Module	3.08 KB (0%)
CommonJS	3.08 KB (0%)
CSS	1.22 KB (0%)