Improve code comments

Summary:
Reviews the Notifications\Phabricator namespace for
better and coherent code comments.

Test Plan: Read again the comments blocks.

Reviewers: dereckson

Differential Revision: https://devcentral.nasqueron.org/D611