Add API alternatives comparison document#154

Open

ElFantasma wants to merge 12 commits intomainfrom

docs/api-comparison

Commits on Feb 20, 2026

docs: add API alternatives comparison doc with updated branch references
ElFantasma
committed
docs: update Approach B examples to match protocol_impl! + aligned caller API
ElFantasma
committed
docs: move Deliver to user.rs in Approach A examples to match actual code
ElFantasma
committed
docs: add cross-crate scaling insight (A's circular dep vs B's clean separation)
ElFantasma
committed
docs: add cross-crate limitation note to Approach A section
ElFantasma
committed
docs: move non-macro Approach A messages into their handler modules
ElFantasma
committed
docs: update Approach A analysis table to reflect no shared messages.rs
ElFantasma
committed
docs: add registry as third problem in API comparison
ElFantasma
committed