docs(notifications): documentation for the notifications system

Fixes #7308
Merge pull request #7366 from juho-jaakkola/notifications_docs

docs(notifications): documentation for the notifications system