Update notes for submitted changes

* reorder documentation