Update notes for submitted changes

* devref policy: code is canonical source of truth for API