Added clarifying documentation around the $event parameter