Improving the Readme?

[meatnordrink]

I'm super excited about some attention being given to the Recoil-to-Jotai conversionprocess! Thank you so much for creating this. Being able to do it incrementally seems essential for larger-scale apps.

I had a couple thoughts on improving the Readme. I'd be happy to open a PR myself, once I'm clear on what the right answer is, but having not actually used the library yet I'm not quite there.

Readme questions

So, I wasn't totally clear from the Readme/explanation, but is my understanding correct that you'd use jotai-recoil-adapter atoms, instead of Jotai atoms, and then you could piecemeal-replace your Recoil atoms with jotai-recoil-adapter atoms? Is the idea that eventually you'd replace all your Recoil atoms with jotai-recoil-adapter atoms, and would then be able to easily switch over to actual Jotai, from jotai-recoil-adapter? And from the examples, it looks like jotai-recoil-adapter is compatible with actual Jotai, so that migration could be piecemeal as well?

I think it might be helpful to make the intended relationship between jotai, jotai-recoil-adapter, and recoil, and the exact role jotai-recoil-adapter plays, clearer in the docs, perhaps with some examples of jotai-recoil-adapter and jotai/recoil interacting.

I was initially hoping this could be used as a bridge between Jotai atoms and Recoil atoms; specifically, I have a Jotai-converted atom that communicates with a Recoil atom, and I found this library while looking for ways to let the two communicate. It doesn't sound like this does quite that (it sounds like I'd need to convert the Jotai atom back to a jotai-recoil-adapter atom first) - which demonstrates to me that there are multiple things someone might be looking for when they find this, and it might be helpful to be exact about what it does do.