From e66196fd248ca710882a1489ea926d790d69cb51 Mon Sep 17 00:00:00 2001 From: Timothy Date: Wed, 26 Aug 2026 22:27:12 +0200 Subject: [PATCH] docs(788): two precision fixes in the vocabulary record MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Round 5 returned MERGEABLE with no must-fix items. These are its two nits, taken because this branch's failure mode has been imprecise prose and leaving a known imprecision to save a round would be the same trade that produced the previous five. * The comma-separated enumeration the sweep cannot see is in the doc COMMENT above `etv_verdict_words_display`, not inside it — the body builds its list from the data. Verified: the comment is at review-verdict-vocabulary.sh:195, the function opens at :198. * The separator parenthetical omitted `\/`, which `(\\?[|/])` also accepts. That was an understatement rather than an overclaim, and it is the one direction this record can afford, but it is still not what the pattern does. Verified by feeding `MERGEABLE\/APPROVED` to the pattern: it matches. No executable line changed. The sweep still runs verbatim and still returns nine real sites including the catalog; catalog regenerated; decisions-validate OK; 989 passed / 2 skipped. Refs: #788 Decisions-Edit: yes Co-authored-by: Timothy --- .../records/release/verdict-vocabulary-shared.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/decisions/records/release/verdict-vocabulary-shared.md b/docs/decisions/records/release/verdict-vocabulary-shared.md index 211ad9aa9..68012363d 100644 --- a/docs/decisions/records/release/verdict-vocabulary-shared.md +++ b/docs/decisions/records/release/verdict-vocabulary-shared.md @@ -104,11 +104,11 @@ done ``` **This sweep is a starting point, not a completeness proof, and the difference is the whole lesson -of this record.** It finds vocabulary words joined by a bare or markdown-escaped separator (`|`, -`/`, `\|`). It does NOT find an enumeration written any other way — the comma-separated list inside -`etv_verdict_words_display` is invisible to it, and so was the generated catalog until the `\\?` was -added, because a Markdown table escapes its pipes. That omission was not hypothetical: the catalog -is a site this record had just repaired, and the sweep reported it as clean. +of this record.** It finds vocabulary words joined by a bare or markdown-escaped separator (`|`, `/`, +`\|`, `\/`). It does NOT find an enumeration written any other way — the comma-separated list in the +comment above `etv_verdict_words_display` is invisible to it, and so was the generated catalog until +the `\\?` was added, because a Markdown table escapes its pipes. That omission was not hypothetical: +the catalog is a site this record had just repaired, and the sweep reported it as clean. Each earlier attempt at this — three counts, then a pattern — failed the same way, by asserting a completeness its author had not established. A string predicate over prose does not converge, which