Writing
Notes from the test
Comparisons and analysis drawn from the published reports.
-
explainer · 2026-09-27 How to document webhooks so AI agents can verify them
The webhook pages that passed give the header, the secret, the algorithm over the raw body, and a timing-safe check. -
explainer · 2026-09-26 How to document API errors so AI agents can recover
The error pages that passed give the wait, the backoff, the stop, and the code. -
explainer · 2026-09-24 How to document API rate limits for AI agents
The limit pages that passed state every number with its scope, on one page. -
explainer · 2026-09-22 How to write documentation for AI agents
The agent-facing files are close to universal. The points agents lose sit in what the pages say. -
analysis · 2026-08-20 Every product tested ships llms.txt. None scores full marks on reading.
Sixteen scores in, the machine-readable surface is close to universal and the writing behind it is not.