Update migrations.rst

More tweaking the migrations documentation. I updated the template output for the migration file.  Please let me know if I should change anything.
Thanks!