Update notes for submitted changes

* refinment of specs readme.