Skip to main content

Incidents

A registry of situations observed on real managed WordPress sites that are likely to recur elsewhere: what the traffic looked like, why it worked, the rule that stopped it, and the legitimate requests that must not be blocked.

Every record follows the incident schema and identifies the affected deployment by placeholder (site-a, site-b), never by domain.

IDSituationClassStatusFirst seenInstancesRule
INC-2026-10-28-01Nested pagination cache-busting floodcache-busting-floodcontained2026-10-28site-aincident-only

Adding a record​

  1. Copy the incident template to docs/incidents/<YYYY>-<MM>-<slug>.md.
  2. Fill the front matter and the eight sections — especially Do not block.
  3. Add a row to the table above.
  4. Run bash tests/test-incidents.sh and npm --prefix website run build.

The test enforces the schema, the site-a placeholders and the section order, and it sweeps the records for hostnames. It cannot detect a bare site title, so read the record before committing it.