diff --git a/README.md b/README.md index e2bc9f4..776ee63 100644 --- a/README.md +++ b/README.md @@ -296,7 +296,52 @@ Three packages in order, and the order is a dependency chain rather than a habit `shared` emits the types and the warning copy both other packages import, `api` compiles `api/src` to `api/dist`, and `web` prerenders against a running API. -Output lands in `api/dist/` and `web/dist/`. Every page is prerendered once per language, so ~55 mints +Output lands in `api/dist/` and `web/dist/`. + +### Live lists + +The prerendered mint list is a snapshot of what `GET /api/mints` said when the build ran. +It used to stay that until the next build, which is why there was a nightly timer: a mint +indexed at noon was reviewable at once — the 404 resolver saw to that — and had no card on +`/mints` until 03:30, beside cards whose ratings and statuses were equally old. + +`/mints`, `/fedimints`, `/lnurl-mints` and the home page's three top-six strips now refetch +that endpoint once, after paint, and rebuild their grids from the answer. One request per +page, no relays involved: card counts have always come from the API's ingested review +aggregates, and review *bodies* remain a mint page and `/reviews` concern. + +**The prerendered cards stay.** They are the first paint, they are what a crawler indexes, +and they are the whole page for a reader with no JavaScript — `