DOC: 6.events.md - improvements