make the notification helper stricter
yard docs for notifications
[skip ci]