MDL-45445 events: documented the additional validation
MDL-45445 events: added '(optional)' to event params where applicable