Even though I know CoffeeScript, these examples are VERY hard to read and understand.
If you prefer writing your code in CoffeeScript, that's fine. But don't force it on your users by showing examples in CoffeeScript. Just write regular js and it'll be a lot clearer how to use this.