Updating migration doc with Michels comments