Add doc on handling migrations when upgrading

Fixes #608