Q.nfcall (and related) documentation is slightly confusing

The documentation at https://github.com/kriskowal/q/wiki/API-Reference suggests that when using Q.nfcall (and friends) the resolved callback is called with a single real return value, while in reality it is an Array with the arguments of the node-style callback in-order (sans the error oc).

So this example snippet:

Q.nfcall(FS.readFile, "foo.txt", "utf-8").done(function (text) {

});

Could be better written like this:

Q.nfcall(FS.readFile, "foo.txt", "utf-8").done(function (args) {
    var text = args[0]
});

It is a small thing but got me confused for a minute.

[kriskowal]

Users can never have too much information to make it easy to use your work. A responsible developer makes good code, documentation, and videos. Anything less is lazy.

True enough. Still, this is a free service we provide in our spare time. You should look at @domenic’s public contributions graph on his Github home page, or even mine. We appreciate your understanding.

I’ll be doing a presentation at Fluent next week. I did a presentation in Berlin in 2010. Domenic and Forebes Lindesay have done numerous good videos. We will take your advice and create an index of some of this ancillary documentation.

[kriskowal]

Ah, there it is. I remembered it but could not find it.