Add more docs for events - addresses #70

Is this ok, @georgecrawford ?