Improve and standardise event docs

Having the general events description in events.condition.jsdoc isn't very logical, but this would resolve itself if #2334 goes ahead.
This is a class, not an instance. So it sounds weird to me that the class description starts with "The event instance...".