Update README.md

Based on customer questions.

Add comments to the migration script!