Используете ли вы JSDoc ?
 

JSDoc это генератор документации. Часто встречал его в кодах известных библиотек. Но лишь недавно узнал что в некоторых редакторах он влияет на авто дополнение кода. Я думаю если создавать что-то серьезное, даже для себя, то обязательно должна быть документация. Потому что через неделю ты помнишь как работает код, а через месяц уже не помнишь. Раньше я делал обычными комментариями. Щас подумал что лучше юзать JSDoc. Что думаете об этом?

http://www.artlebedev.ru/tools/techn...eclipse-spket/

а вот объяснение тегов на русском

http://vingrad.ru/blogs/Alix/files/2...discussion.pdf

С недавних пор - использую.
Ранее использовал только PHPDoc
За ссылки спасибо

сейчас начал использовать. классная штука. до этого я пытался сделать то же самое, но через комментарии (не знал, что существует JSDoc)

ой как знакомо))

Да-да, плюс один) У меня была система xml-комментирования)

Livaanderiamarum, теперь буду пользоваться этим..)

Да, таки клёво, в WebStorm тоже вроде работает :)

Кстати, имхо, куда более клёвая документация - вот здесь:
http://code.google.com/p/jsdoc-toolkit/wiki/

Кстати, а у разрабов браузеров нет желания использовать JSDoc в целях ускорения кода? Например, смотреть типы переменных по ним...

чето не очень, элементарно вбил ему тип CSSStyleDeclaration, показывает старые свойства CSS тоесть вместо borderRadius, показывает MozBorderRadius и т.д. Очень старая дока у них вбита.

Использую где-то около года.

Кто как расписывает аргументы в виде объекта?

Я делаю так:

/**
* @param {Object} o
* @param {String} o.title
*/
function (o) {

}

Gozar, а как ещё ?

HTMLStyleSheet вообще ничего не выдаёт