Added migration guide

@ebressert - does this look ok? Is there anything else you can think of that we need to mention here?