Update notes for submitted changes

* harness API design proposal