Improved `DatabaseMigration`
 - added javadoc with instructions
 - improved parameter checking