Add notifications documentation.
Fix spelling mistakes in notifications document.
Merge branch 'notifications_documentation' into 'master'

Notifications documentation

Fixes #1583

See merge request !1177