Update notes for submitted changes

* Misc language and markup improvements to swift
Update notes for submitted changes

* Changes public_interface to match