docs(notifications): documentation for the notifications system

Fixes #7308