tweaks to migration guide