Cleanup DocBlocks and comments.

Removed unnecessary whitespace and added missing variables to the DocBlocks.
I've been following Vimeo's internal code standards here. Newlines for braces on classes, everything else is same line.