[jmnote]

Summary

Addresses the review feedback on #10.

Changes

• PDF download link: The URL is now built from the site base, so it works on exporter sub-routes. Standalone make dev also serves /<year>/*.pdf. The decks' sourcePdf is now a site-root-relative path.
• make site robustness
  • Malformed percent-encoded URLs and Referer headers no longer crash the server; they get a 400 or a fallback. (site-request.mjs + tests)
  • Ports are checked up front, and dead or failed deck servers are logged.
  • The request body is drained on upstream errors.
• make preview: The showcase build goes to dist-preview/, so dist/ is no longer overwritten.
• Misc
  • Class labels strip \ and newlines.
  • Hidden slides are skipped in section numbering.
  • The SHOWCASE constant is shared and the showcase link is escaped.
  • Added .prettierrc.json.
  • Commented the !important rules and the staircase default.
  • README now notes the per-deck dev server.

Not included

• Splitting the CSS reformat out of Shared slide templates and PPTX-aligned k8s-ai-agent deck #10: it is already merged, so only the formatter config is added.
• 2023 cover-bg.png: it differs from tooling/site/images/cover-bg.png and is still used, so it stays.

Verification

• pnpm check passes (17 tests, README sync, full build)
• make site: /% returns 400 and the list still returns 200; the PDF is served as application/pdf
• Standalone dev server: the PDF is served as application/pdf