[melky]

Комментирую все функции по стандарту JSDoc GCC. Профит в том, что потом можно юзать GCC как валидатор коду + проще юзать advanced mode, а также по таким комментам легко делать генерацию доки в HTML.

Некоторые IDE, например WebStorm, умеют использовать такие доки для "умного" автокомплита, т.е. также как и у типизированных языков без необходимости подключения специальных библиотек.

люто плюсую, JSDOC неплохо помогает для "компиляции" кода из понятного (dev) в быстрый (adv-min).

кстати, какие флаги GCC вы используете? у меня такие :

// вывод сообщений минификатором, если что-то не так
warning_level: 'VERBOSE',
// я пишу в строгом режиме 
language_in: 'ECMASCRIPT5_STRICT',
// продвинутый режим - наше все
compilation_level: 'ADVANCED_OPTIMIZATIONS',
// использовать типы для оптимизации - типы берутся из JSDOC
use_types_for_optimization: null,
// вывод о качестве минификации и ошибках в конце минификации
summary_detail_level: 3,
// оборачивать исх. код в анонимную функцию - продвинутый режим иногда убивает ее.
output_wrapper: "'(function(){%output%})();'",

потому что это jsdoc

nope sir

JSDOC - это вот:

/**  две звездочки в начале  */

а эти звезды на каждой строке - красивости Jetbrains и др.