Update api docs to better describe tokens

Fixes #87
Merge pull request #88 from denibertovic/fix_token_ambiguity

Update api docs to better describe tokens