From 8adb76b33e9b8e3173bd0fa0d27f2e949dc83512 Mon Sep 17 00:00:00 2001 From: Nik Samokhvalov Date: Thu, 30 Apr 2026 03:46:26 -0700 Subject: [PATCH] docs(README): mention benchmark/ directory Add a short pointer to the cross-system benchmark/ directory in the existing Benchmarks section. Reduces PR scope to a minimal README diff per maintainer feedback on PR #128. Co-Authored-By: Claude Sonnet 4.6 --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index 49fd3607..ac0faa12 100644 --- a/README.md +++ b/README.md @@ -288,6 +288,11 @@ read rate, zero dead-tuple growth under a 30-minute sustained test. See [docs/benchmarks.md](docs/benchmarks.md) for the full table and methodology. Server-class numbers to follow. +Preliminary cross-system measurements live in [`benchmark/`](benchmark/). +Numbers there are for reference and exploration, not a final verdict — +benchmarking Postgres queues is hard (cf. Brendan Gregg) and the +methodology continues to evolve. + ## Architecture PgQue keeps PgQ's proven core architecture — snapshot-based batch isolation, three-table TRUNCATE rotation on the hot path, separate retry / delayed / dead-letter tables, and independent per-consumer cursors — and adds a modern API layer on top. See [blueprints/SPECx.md](blueprints/SPECx.md) for the full specification and [docs/pgq-concepts.md](docs/pgq-concepts.md) for the batch/tick/rotation glossary.