feedback from code review
Merge pull request #132 from forio/documentation

feedback from code review