@darius You don't see this kind of document very often but they're darned useful.

If nothing else there are lot of APIs out there that could use something like this to bridge the gaps between "here's all the things you can do" and "here's how to USE the API".