Should programming language docs come with exercises for the reader to test their understanding?
This feels like a great way to help people learn, and you could even measure docs by pass rate.
I've seen online books occasionally use this format, but never official resources.