Update notes for submitted changes

* add some documentation, clean up a little bit