Updated the docs for migrators so they're at least a bit more helpful.
Merge pull request #1136 from mojombo/migrators-docs-updates

Updated the docs for migrators