Please add a description of the arguments in the docstring and an example usage.  (JQuery promises can be less than intuitive)