event: add some documentation