added phpdoc function comments

https://github.com/GigaOM/gigaom/issues/4269