Add caveats about api limitations. Also doc our own api a bit more.