Update notes for submitted changes

* use a sane documentation standard