Seems like a great api. If it only had javadocs.

That would require that the code was all documented, as the lib is quite new this isn't done yet.
I'll leave this here as an action item.