update to readme and spec