[megaupload]

Зачем * на каждой строке?

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

Не комментирую функции, имя функции должно отражать ее функционал

а если английский не знаешь

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

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

бро)