readme and spec updates