more documentation for events