improved migrator doc