moving the migration guide over from the wiki, couple small edits