Просто любопытно, как можно прокомментировать, какие параметры будут переданы функции обратного вызова.
Предположим, у нас есть следующий код и неполные комментарии
/**
* an utterly useless function
*
* @param {String} an useless string
* @param {Boolean} an useless boolean
* @param {Function} ???
*/
function Useless (str, bool, callback) {
callback(str, bool);
}
Как правильно сказать, что обратный вызов будет вызываться с параметрами str и bool?