Update notes for submitted changes

* updated spec with more detail