more docs on decoupling through events