Цитата:
Сообщение от kobezzza
(Сообщение 235764)
Комментирую все функции по стандарту 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%})();'",
Цитата:
Сообщение от megaupload
потому что это jsdoc
|
nope sir
JSDOC - это вот:
/** две звездочки в начале */
а эти звезды на каждой строке - красивости Jetbrains и др. |