When the API is considered stable for this, at the moment it’s unstable (manual migrations).
The automated migrations has really no documentation other than how to disable it. Once we add the file dump mechanism then we will add some docs for that. For the bulk of use-cases the automated system should handle everything for you.