Updated the docs for migrators

Had a great chat with someone on the jekyll IRC channel and did some troubleshooting. Turns out our docs are basically useless. This should help clarify the current state of things a bit.