more documentation for migrations