revisions to migration guide