Start improving the events documentation.

I'm trying to make the examples more succinct, direct and contain fewer
sub-optimal implementations.
Update other event subsections.
Clean up conclusion.
Tidy things up.
Address comments.
Merge pull request #806 from cakephp/improve-events

Improve events documentation