В JS можно документировать функции в широко распространённом формате JSDoc. На основе таких комментариев позднее можно сгенерировать документацию в HTML или PDF. Пример:

/**

* Represents a book.

* @constructor

* @param {string} title - The title of the book.

* @param {string} author - The author of the book.

*/

function Book(title, author) {

}

В JSDoc используются следующие тэги:

Описание параметров/аргументов функций производится при помощи тэга @param имя тип описание.

• В качестве типа могут быть использованы следующие значения: базовые типы данных JS -- boolean, number, string, Object, либо имена классов, определенных в коде.
• Можно объединять типы: {(number|boolean)}
• Можно описывать массивы: {number[]} или {Array.<number>}
• Nullable-тип: {?number}
• Non-nullable-тип: {!number}
• Неизвестное заранее количество аргументов: {...number}
• Опциональный параметр: @param {number} [foo] или @param {number=} foo