> Are there any documentation posts that you've seen that can be adapted in > this manner? Create an issue for this, compile a list of improvements?
There is not just a list of specific issues in the docs. The fact is that they have to be completely rethought in a way that allows people learn deeply the language and to understand its details. That is not possible with two or three paragraphs for whole sections of the language API.
