Improved Documentation for Mediators.
It was a bit insufficient and at some points just wrong..