event documentation, part 1"

This reverts commit 82d3d68611584f0c933c83abd91ab7bbb2fc33af.