I feel this comment is already much more constructive than your original one.

Btw I'm not affiliated with Pony in any way, so I have no influence on what and how things could be improved in the docs.