Remember that the goal of docs is making sure developers have documentation that serves them well. When it comes to pretty much any part of how a language is explained, you can ask:
- Is this easy to understand? Can I read this and just go do what it's explaining?
- Are there common pitfalls that I and others fell in because the 'wrong' way wasn't well explained?
- Can someone working on real-world stuff relate well to the examples?
- Is the reasoning behind things explained well where it needs to be?
.. if the answer to any of that is "no", then make something better :) If it's all "yes", then there's not really much to do.