O problema é que essas documentações são feitas por profissionais técnicos que conhecem bem o código, mas acabam abstraindo demais e condensando excessivamente as explicações. Com isso, muitas vezes é necessário um conhecimento prévio e uma compreensão de certos conceitos para conseguir entender a ideia por completo.

O pior é que, depois que você finalmente entende, bate uma frustração enorme com a forma como a documentação foi escrita. Acho que a documentação é extremamente negligenciada em muitos projetos, inclusive em casos onde ela é fundamental para atrair e conquistar novos clientes. Das que já tive acesso, a do ecossistema do Facebook está entre as piores.