@mxcl has noted that the documentation of what's in the library is not very good. (No, header files don't count.)
I've added a method breakdown and design philosophy to the readme. They need to be improved more.