Add documentation for new android API.

This API is currently in flux, so the changes are going to be pretty volatile
for a while. That said, it's a way to start documenting our API in Android.