Revert "Revert "update notifications documentation""

This reverts commit 52ce7f7533cba0901018cf9a6113e5ea1a1c8a24.