README and spec updates (minor)