Improve events documentation

I got some feedback that the events documentation could be a bit more streamlined and contain more relevant examples. I've tried to address the relevance of the examples by removing complex or 'bad' examples, and instead focus on the right way to do things.