|
Сообщение от Poznakomlus
|
|
Неправильное мнение. Так как система комментариев иногда используется для подсветки параметров
|
Ну не об этом же речь. Без фанатизма. Речь как раз о таких вот примерах, как у
Ruslan_xDD, когда лучше дать понятное имя функции и ее параметрам (а также локальным переменным), нежели писать поясняющие комментарии. Еще в JSDOC дается описание параметров, хотя чаще всего оно просто дублирует инфу, уже вложенную в имя самого параметра:
/**
* Sets a new editsession to use. This method also emits the `'changeSession'` event.
* @param {EditSession} session The new session to use
*
*
**/
this.setSession = function(session) {