The README now documents:
- Architecture: the static build/serving model, the content -> public/
-> pagefind/ data flow, the SCSS compile pipeline (why the Hugo
extended build is required, SRI fingerprinting), where
customizations live (_variables.scss table, search.html), the
data-pagefind-body index-scoping mechanism, the #search CSS cascade
trick, and the four Pagefind 1.5.2 quirks the UI works around
(stretched form, no-op Enter, empty thumbnail, UA-yellow marks)
- Every Makefile target with what it does and the gotchas (serve does
not rebuild; serve-lan is plain static; build runs --gc)
- Search usage incl. the new keyboard navigation, and a table of the
current #search customization values
- Dead-link automation (internal/external split, idempotent
comment-out, daily cron job)
- Troubleshooting for the new failure modes and a do-not-commit list
noether
surfninjas