docs(guide/migration): clarify some confusing points

Closes #6756