added documentation of interacting components