From 2ad4d022aa83a069b49a421e6a35f5358af0331f Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 17 Nov 2026 22:20:21 -0500 Subject: [PATCH] docs: note the deliberate 1 req/s REST rate (review on #73) Co-Authored-By: Claude Opus 5.5 --- docs/night2/WIKIMEDIA.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/night2/WIKIMEDIA.md b/docs/night2/WIKIMEDIA.md index 241f24c..3979092 100644 --- a/docs/night2/WIKIMEDIA.md +++ b/docs/night2/WIKIMEDIA.md @@ -18,6 +18,10 @@ Every server-side Wikimedia request goes through one process-wide `WikimediaClie | Disk cache | `$WIKIDECK_DATA_DIR/wikimedia-cache.sqlite`: ETag / Last-Modified, `If-None-Match`, stale-while-revalidate on the background lane, stale copy served on refusal | | User-Agent | `WikiDeck/ (+https://gitea.eom.dev/WikiDeck/wikideck; ) node/` | +The rate is deliberately 1 req/s for **every** host, including the `wikimedia.org` REST (pageviews) host. +The engineer review suggested 5 req/s there; we are stricter on purpose after the Night 1 rate limiting, because the +budget is per egress IP. Raise it only with a reason and a per-host setting. + Cache lifetimes: article metadata 24 h, monthly pageviews 7 days (the URL names six closed months, which do not change). Random articles and all mint reads are never cached.