Skip to content

Commit 1767572

Browse files
committed
doc: describe the permit bound as the fraction it now is
The design document described the permit fraction in nano-fractions of the worker count. The parameter is a plain `f64` fraction, so the description matches what an operator sets.
1 parent bb11bf5 commit 1767572

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

doc/developer/design/20260825_peek_execution.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -406,11 +406,11 @@ Four parameters:
406406
whose rows are bound for the stash suspends once its accumulation crosses
407407
`peek_response_stash_threshold_bytes`, by far the smaller trigger at that
408408
parameter's default, so such a walk yields per batch.
409-
* **Permit fraction**, default one permit per timely worker, expressed in
410-
nano-fractions of the worker count the way Kubernetes expresses a CPU share.
411-
How many promoted scans may run at once. It bounds running scans and nothing
412-
else, and the queue that forms behind it is a signal rather than a second
413-
bound.
409+
* **Permit fraction**, default `1.0`, a fraction of the timely workers a compute
410+
runtime runs. How many promoted scans may run at once, floored at one scan.
411+
Expressed as a fraction so the bound scales with the replica rather than being
412+
retuned per size. It bounds running scans and nothing else, and the queue that
413+
forms behind it is a signal rather than a second bound.
414414

415415
A peek passed over for want of budget is served before the peeks that were served
416416
ahead of it, which takes two pieces beyond the counters. The sweep records the

0 commit comments

Comments
 (0)