Cara, na verdade essa questão de documentação, de certa forma, mal feita é um problema para a grande maioria das biobiotecas/frameworks ou ademais ferramentas.

Isso pode até ter mais a ver ao fato de que o programador acaba focando tanto no lado tecnico que quando vai interagir com seres humanos, parecem falar gregos kkk. Muitas vezes esquecemos que a comunicação é crucial para que nos façamos entender!
Honestamente, acredito que é o que acontece com as documentações. Focam em produtos incriveis mas esquecem da parte de se comunicar com o humano.

Pelo menos, a parte boa é que tem como sugerir mudanças na documentação, pelo menos na do Next Js