Update notes for submitted changes

* re-arrange docs for clarity