This is the generic event order no? i.e. events will happen in this order and it doesn't matter which method you call, so I think something like "Events are fired in the following order when you call ``$dm->flush``' would be all that is needed.