Update README and spec comments to match reality