Update README.md with some more info

I filled out the readme a little, but I didn't feel confident enough with in particular the content about the API and using the latest master to just push it. If someone else looks at this and thinks it looks good, please merge.