Better error message was indeed the motivation (the link_resolver thing might turn out as the most complex indispensable concept to grasp for users, so they will most likely need us to make it easy for them)
I'll check out your commits right now, but clearer documentation is always a good thing anyways. :)