Elaborated on use cases and added note that the API should be rewritten to use promises.
Merge pull request #3 from ClaesNilsson/gh-pages

Elaborated on use cases and added note that the API should be rewritten ...