nerv_, JSDoc удобнее (имхо). я так же, как и ты, расписывал всё в комментах, но когда узнал про jsdoc, мигом перешёл "на тёмную сторону". у них такие вкусные печеньки - при долгом использовании jsdoc станет читаться и пониматься так же легко, как и обычные комментарии, а ещё всё это выводится с тултип сбоку при вызове чего-либо описанного.

tempResult, например)

Я за jsDoc и вменяемые названия переменных. Вы потратите чуть больше времени сейчас ради сохранения его в будущем)

Ну лично я пишу функции универсальными, да, я трачу на это время, но за то функция совсем не зависит от среды. И я потом даже частенько компрессую их и так храню, потому что не собираюсь менять их или дорабатывать)) потому что они уже работают и в случае чего я могу передать обьект с настройками во время "приготовлениия" функции в котле анонимной функции(макс придумал так называть)