doc/api: message events documentation updated