как лучше комментировать

[neWjs]

Как лучше написать комментарий для параметров передаваемых функции, к примеру , функции foo, передаеться объект со свойствами a,b.

// описать свойства которые могут быть установленны
function foo(params) {
 return params.a + params.b;
}

[kobezzza]

// описать свойства которые могут быть установленны
function foo(params) {
 return params.a + params.b;
}

JSDoc
http://ru.wikipedia.org/wiki/JSDoc
https://developers.google.com/closur...s-for-compiler

/**
 * @param {!Object} params
 * @param {string} params.a - описание, параметр 1
 * @param {string} params.b - описание, параметр 2
 * @return {string}
 */
function foo(params) {
 return params.a + params.b;
}

[melky]

описывать лучше в формате JSDOC

/**
 * Применит плюс к свойствам "a" и "b" переданного объекта
 * @param {{a: string, b: string}} params
 * @return {string}
 */ 
function foo(params) {
    return params.a + params.b;
}

[neWjs]

melky,
kobezzza,
спасибо.