I’ll dig into them. I skimmed them when hooks were first announced and felt like it was just a way to bolt on state to functional components. I should really revisit the intent of hooks.

The hooks docs are complete garbage. They don't explain anything properly and they use dumbed down language that ambiguates important details, in an attempt to make them more "accessible" to beginners (that somehow are too stupid to understand classes but can magically grasp these far more advanced concepts?).

Dan's blog post is much better, in comparison. Start with that maybe.

If you think the docs can be improved, please submit PRs:

https://github.com/reactjs/reactjs.org

Why bother? There's no way a PR is going to get through on this. The entire Facebook team seems to fundamentally disagree that web developers should understand code rather than just write it.