more event docs refactoring