migrations guide: fix and edits [ci skip]