better documentation for migrations