Improve documentation by describing notifications

Nothing works without these notifications :-) It feels remiss not to document them.