add better documentation to the eventing system