expanded db-migration doc