Improve code comments

Summary:

• End each sentence with a final dot for
• Side edit: same amount of blank lines at class start and class end

Test Plan: Read again the comments. Regenerate doc.

Reviewers: dereckson

Subscribers: alken-orin

Differential Revision: http://devcentral.nasqueron.org/D441