> IMO if you need a long doc like this pointing out the sharp edges, then I think you've done a poor job in designing the framework.

Thank you. It's self-serving (mea culpa), but this is the exact reason I moved away from React and decided to build Joystick [1].

[1] https://github.com/cheatcode/joystick