The README Basic Usage example (README.md:137-197) sends 5 items through a config of {MinItems: 2, MaxItems: 5, MinTime: 10ms, MaxTime: 100ms} and claims:
Expected output: 2 4 6 8 10
With MinItems: 2 the 5 items can split into multiple batches, and batches are processed in separate goroutines — so both the order and the grouping of the printed lines are non-deterministic. This is the same class of problem #69 fixed in example_test.go (which now uses a single-item, single-batch config); the README front-door example was left behind.
Fix: either use a config that guarantees one batch (e.g. MinItems: 5, MaxItems: 5) or soften the claim to "Output (order may vary)". Land together with the #84 config-semantics doc fix if convenient.
Found in the 2026-07-10 full-repo review.
The README Basic Usage example (
README.md:137-197) sends 5 items through a config of{MinItems: 2, MaxItems: 5, MinTime: 10ms, MaxTime: 100ms}and claims:With
MinItems: 2the 5 items can split into multiple batches, and batches are processed in separate goroutines — so both the order and the grouping of the printed lines are non-deterministic. This is the same class of problem #69 fixed inexample_test.go(which now uses a single-item, single-batch config); the README front-door example was left behind.Fix: either use a config that guarantees one batch (e.g.
MinItems: 5, MaxItems: 5) or soften the claim to "Output (order may vary)". Land together with the #84 config-semantics doc fix if convenient.Found in the 2026-07-10 full-repo review.