Yew Agent documentation
TiemenSch opened this issue · comments
This is about:
- A typo
- Innaccurate/misleading documentation (e.g. technically incorrect advice)
- Undocumented code
- Outdated documentation
- Other
Problem
https://github.com/yewstack/yew/blob/master/website/versioned_docs/version-0.21/concepts/agents.mdx
The agents page states that agent communication happens over the bincode codec while it merely is a default. However, just like with gloo-worker itself, the Codec is already perfectly changeable.
Especially since bincode does not support "complicated" data in the sense that deserialize_any is unsupported (bincode-org/bincode#386). This might prevent users from adopting a WebWorker or send them in a deserialization rabbit-hole as their data fails to be passed over the fence with bincode.
Also, is the public/private agent still a thing?
Details about the solution you'd like
I think the most pragmatic solution would be to change the docs to state that bincode is merely the default and point to the Fibonacci example that already uses postcard instead of bincode. yew-agent's docs itself could also point a bit better to what components dictate the codec (Registrar and Provider).
Additional context
yew/examples/web_worker_fib/src/agent.rs
Line 10 in f6b23f0
Questionaire (Optional)
- I'd like to write this documentation
- I'd like to write this documentation but I'm not sure what's needed
- I don't have time to add this right now, but maybe later