Update readme for 1.0

**We don't want to merge this until we're live with 1.0**
@redmunds i tweaked your suggestion a bit and added it near the end of the previous section (jinx)