add documentation/warning on execution order of methods
@gstark requested that we explicitly specify the order in which methods get called on an algorithm. While the call order for fileExecute() was always unspecified, it was not explicitly unspecified; which apparently lead some people to take the current implementation as the specification. Now it is explicitly unspecified, hopefully improving the situation.
see !20461 (merged)