documentation tweaks
update Changes to spec