Update readme for 1.0

**We don't want to merge this until we're live with 1.0**
Agreed. Seems like it belongs at end of previous section.