Most of the API is decently clear. I have some questions, but for at least some of them, I doubt they're anything machine readability would help with.

/