document the module migration behavior

It's important to note that you aren't necessarily going to end up with the same module versions after a module migrate, which could result in application compatibility issues after the upgrade.
Merge pull request #358 from markstos/develop

document the module migration behavior