document configurable event dispatching