added phpdoc function comments

https://github.com/GigaOM/gigaom/issues/4269
Added function comments.
Merge pull request #9 from kgneil/phpdoc

added phpdoc function comments