added documentation for functions

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