How To

Step-by-step tutorials for the tasks developers run again every few months. Each guide names the prerequisites, walks the steps with the exact commands, ends in a verification a script could check, and links the umbrella pages it builds on.

Pages

  • deploy-quartz-site: Fork Quartz, wire the GitHub Pages workflow, point a custom domain, verify with curl.
  • set-up-claude-code: Install Claude Code, write the CLAUDE.md anchor, set up TODO.md, ship the first PR.
  • add-jsonld-to-static-site: Pick the right schema types, inject JSON-LD into <head>, validate with the Rich Results Test.
  • optimize-core-web-vitals: Measure with CrUX and web-vitals, fix LCP, CLS, and INP, re-measure at p75.
  • write-llm-friendly-content: Ship /llms.txt, /ai.txt, JSON-LD, OG cards, raw markdown links, and named heuristics agents can cite.
  • ship-llms-txt: Decide structure, write the summaries, place the file at the site root, link from robots.txt and ai.txt.
  • debug-postgres-slow-query: Enable pg_stat_statements, find the offender, run EXPLAIN ANALYZE BUFFERS, add the right index, confirm the new plan.
  • run-a-quartz-static-site-locally: Clone, install Node 22, run npx quartz build --serve, fix port, theme, and plugin-order errors.