Clarify Events docs

Attempt to clarify the gaps in the documentation raised in #2130