Adds some comments to the TypedAPI
Merge pull request #832 from twitter/add-typeddocs

Adds some comments to the TypedAPI
Merge branch 'develop' of https://github.com/twitter/scalding into develop