We need a way to document callback argument. For example, given:

var MyFunction = function(onSuccess, onFailure) { ... }

I need to document the arguments I will be passing into onSuccess and what return values are acceptable. There are workarounds for documenting the callback parameters, but they result in documentation that is hard to read. There is no known workaround for documenting the callback return values.