Fixes incorrect `TokenBucket` comment, adds details
Merge pull request #424 from jessedhillon/bugfix-token_bucket_docfix

Fixes incorrect `TokenBucket` comment, adds details