Update notes for submitted changes

* README improvements
Update notes for submitted changes

* Updated docs