davsclaus commented on PR #27079: URL: https://github.com/apache/camel/pull/27079#issuecomment-5908634052
Following up on the Choice ↔ Switch cross-linking: please add a `TIP` block near the top of each page (before the Options section), so readers who land on one immediately learn the other exists and how the two differ in design. **`switch-eip.adoc`** — the intro paragraph mentions `direct:` in passing; a TIP makes the design intent explicit: ```adoc TIP: Switch has no inlined sub-routes: each case sends to a single endpoint. This fosters a design where each branch is its own route, linked via xref:ROOT:direct-component.adoc[Direct] or xref:ROOT:seda-component.adoc[SEDA], keeping the dispatch table flat and each branch independently readable and testable. If you need predicates, ranges, or inlined processing steps in the branches, use the xref:choice-eip.adoc[Choice] EIP instead. ``` **`choice-eip.adoc`**: ```adoc TIP: If you route on the literal value of a single expression (a decision table), consider the xref:switch-eip.adoc[Switch] EIP. Unlike Choice, Switch does not have inlined sub-routes; each case sends to one endpoint, typically another route linked via xref:ROOT:direct-component.adoc[Direct] or xref:ROOT:seda-component.adoc[SEDA]. ``` (Remember to regenerate the catalog doc mirrors afterwards.) _Claude Code on behalf of davsclaus_ -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
