Document the notification object a little

Comments welcome - just quickly threw this together as it improves #154 by documenting more of the object.