It's now documented and everything: https://docs.djangoproject.com/en/dev/topics/migrations/#upg...