docs(*): adjustments to events docs