Remove warning about API instability from README

I consider the API to be stable now, wherefore I have removed the
warning about breaking changes from the README.

Also, I also made some other, minor changes to the README.