updating readme to point out promise is returned, add example
trim results