Improve docs on how to handle migrations when upgrading

As it came up on the mailing list again, I've clarified a few more
scenarios of what needs to be done with migrations when upgrading.