To be honest, I think no one actually reads the files while doing an update etc.
So either it should be mentioned in the ACP or at the end of the migrations