Where
docs/src/content/docs/routing/strategies.mdx → line 357, <Aside type="caution" title="No scatter-gather">docs/src/content/docs/de/routing/strategies.mdx → line 375, the same aside as "Kein Scatter-Gather"
What's wrong
Both language versions of routing/strategies.mdx carry a caution telling the
reader that actor-ts has no scatter-gather router and that they must build one
themselves:
Some actor frameworks have "scatter-gather" routers that send the same message
to N routees and reply with the first / best / merged response. actor-ts
doesn't ship one; you'd build it as a custom router actor that wraps ask
over the routees and consolidates replies.
It does ship one. Router.scatterGatherFirstCompleted is implemented at
src/Router.ts:314, with a whole options family beside it
(src/ScatterGatherOptions.ts, src/ScatterGatherRouter.ts), and the feature
issue #153 that introduced it is closed.
The aside also contradicts four sibling pages in its own directory, per language:
routing/scatter-gather.mdx — an entire page dedicated to the routerrouting/router.mdxrouting/overview.mdxrouting/pool-vs-group.mdx
...and their de/ mirrors. So the one page a reader lands on when comparing
strategies is the only page that denies the feature exists.
Suggested fix
Delete the aside from both strategies.mdx files, or replace it with a pointer:
Scatter-gather: see Scatter-gather —
Router.scatterGatherFirstCompleted(n, Routee) sends to N routees and replies
with the first completion.
The de/ mirror gets the same change with translated prose, per the docs DoD.
Kind
Outdated — refers to a removed feature
(More precisely: it predates an added feature. The aside looks like it was
written before #153 landed and was never revisited.)
Notes
Where
docs/src/content/docs/routing/strategies.mdx→ line 357,<Aside type="caution" title="No scatter-gather">docs/src/content/docs/de/routing/strategies.mdx→ line 375, the same aside as "Kein Scatter-Gather"What's wrong
Both language versions of
routing/strategies.mdxcarry a caution telling thereader that actor-ts has no scatter-gather router and that they must build one
themselves:
It does ship one.
Router.scatterGatherFirstCompletedis implemented atsrc/Router.ts:314, with a whole options family beside it(
src/ScatterGatherOptions.ts,src/ScatterGatherRouter.ts), and the featureissue #153 that introduced it is closed.
The aside also contradicts four sibling pages in its own directory, per language:
routing/scatter-gather.mdx— an entire page dedicated to the routerrouting/router.mdxrouting/overview.mdxrouting/pool-vs-group.mdx...and their
de/mirrors. So the one page a reader lands on when comparingstrategies is the only page that denies the feature exists.
Suggested fix
Delete the aside from both
strategies.mdxfiles, or replace it with a pointer:The
de/mirror gets the same change with translated prose, per the docs DoD.Kind
Outdated — refers to a removed feature
(More precisely: it predates an added feature. The aside looks like it was
written before #153 landed and was never revisited.)
Notes
all-failedalthough it has an error row of its own #1089 and Scatter/gather: the group variant from #153 was not built — the decision is in the commit body only, not on the issue #1090 are further evidence the router isreal and in use; neither covers this stale aside.
passes flagged the same contradiction; verified by hand against
src/Router.ts.