more messages during migrations, add some explanation in sample project's config file