Improved inline documentation in bp-notification-actions.php

Fixes #5524

Props rzen

git-svn-id: https://buddypress.svn.wordpress.org/trunk@8261 cdf35c40-ae34-48e0-9cc9-0c9da1808c22