updated documentation for events