refactored migration guide