From 5a372e5cb6ffc2f815221b0dc99fc56ccef9ee19 Mon Sep 17 00:00:00 2001 From: Avanti Date: Mon, 16 Nov 2026 13:00:21 +0530 Subject: [PATCH] docs: enumerate the harness's three missing refusals (#1143) Include the three harness refusals in docs/rewrite/benchmarks.md that were previously omitted: - --out naming a directory - --out whose parent cannot take a new file - --store with --backend postgres --- .changeset/benchmark-refusals-list.md | 2 ++ docs/rewrite/benchmarks.md | 12 +++++++----- 2 files changed, 9 insertions(+), 5 deletions(-) create mode 100644 .changeset/benchmark-refusals-list.md diff --git a/.changeset/benchmark-refusals-list.md b/.changeset/benchmark-refusals-list.md new file mode 100644 index 000000000..a845151cc --- /dev/null +++ b/.changeset/benchmark-refusals-list.md @@ -0,0 +1,2 @@ +--- +--- diff --git a/docs/rewrite/benchmarks.md b/docs/rewrite/benchmarks.md index 561162e9f..12467ed84 100644 --- a/docs/rewrite/benchmarks.md +++ b/docs/rewrite/benchmarks.md @@ -323,11 +323,13 @@ The harness's contract is three exit code values, the same ones `--help` states: A refusal is answered before the store is opened and prints one line: a corpus below the minimum — the ingest phase takes the corpus's last thousand events, and the bulk phase needs one more to -have anything to load — or above the ceiling, a `--out` directory that does not exist, a -`--repeats` below one, a `--store` directory that already holds a store at any path the repeats -would open, a Postgres run without `PARITY_ADMIN_URL`, or a running `rustc` — a build on the same -box distorts the numbers about threefold, so pass `--allow-busy-host` only when the measurement is -a smoke test. Progress goes to stderr, so stdout never carries anything a script would parse. +have anything to load — or above the ceiling, a `--out` directory that does not exist, a `--out` +naming a directory, a `--out` whose parent cannot take a new file, a `--repeats` below one, a +`--store` directory that already holds a store at any path the repeats would open, a `--store` +with `--backend postgres`, a Postgres run without `PARITY_ADMIN_URL`, or a running `rustc` — a +build on the same box distorts the numbers about threefold, so pass `--allow-busy-host` only when +the measurement is a smoke test. Progress goes to stderr, so stdout never carries anything a script +would parse. ## Context from job 007, not this rig's numbers