Rework the README.md so it isn't blatantly incorrect and massively out of date. 

Probably also point to the original issue and the design doc.