Ответ 1
Инструментарий JS Documentation, который я использовал, просто добавляет комментарии к строкам в любом случае, позволяя поместить все, что угодно, в раздел {type}.
Вы можете придерживаться типов JavaScript, если хотите, например {Number}, или если вы хотите указать, что вы могли бы сделать {integer}... Я бы, вероятно, рекомендовал что-то вроде:
@param {Number} myParam must be an integer
веселит