Update notes for submitted changes

* factor out schema builder