Confusing state regarding Capabilities and (Managed) Effects.

[mknet]

At the moment, the state of the effects handling is to me in a confusing state. On one hand the docs tell me not to deriving Effect but to use the effect macro. But then I have to implement WithContext manually if a want to invoke Core::new().

If I look in the in the HelloWorld page I see the example with just () for the associated type Capabilities which doesn't work either in case of Core::new() usage.

Am I missing something or are we in a rather difficult state of the migration from Capabilities to Managed Effects?

I'd love to help by extending the docs or examples. But before I start I just want to sync with you guys about your thoughts and ideas how I could help.

Thanks and looking forward to push crux forward.

[mknet]

I just came the conclusion that I was getting wrong that the union type does not have to implement WithContext - my bad. Anyways, it's still confusing and I would love to clear this part up.

[charypar]

@mknet Everything should work without ever needing any part of the old-style capabilities. See, for example, the counter example's app.rs: https://github.com/redbadger/crux/blob/master/examples/counter/shared/src/app.rs. In fact all the examples hould have no trace of the capabilities now.

The only reason that API is still around is to give older apps a chance to upgrade in their own time. Removing the associated type and third argument to update is the big breaking change removing the support, so we want to proceed carefully. There's a bit more detail about this documented here: https://redbadger.github.io/crux/guide/effects.html.

We will remove every trace of the old capabilities in the future, probably a few months from now, but haven't made any final decisions yet.

[mknet]

@charypar Thanks for you answer. I am aware of the idea of backwards compatibility. I was just referring to the state of the docs which are not as easy to understand as it could be.
Anyways, I got your point. If you need any help or support, just let me know.