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

Adds some comments to the TypedAPI