Make sure README is up-to-date

[jeancochrane]

We have a bunch of changes to this repo queued up for this month. Once things are in a stable state, let's make sure to take a pass at the README and make sure it's up-to-date with the latest version of the code.