Комментируете ли вы свой код?

Собственно, сабж.
Комментируете ли вы код, если пишите для себя? Если пишите на заказ?
Насколько подробные комментарии (если они вообще есть)?
Используете ли вы обсфукаторы?

Примерно 20 % символов в скрипте это коментарии
неважно для себя или клиента

Код обязательно комментируется, причем всегда используются форматы, пригодные для автодокументирования. Например:

Java - JavaDoc
.NET - NDoc
С++ - Doxygen
PHP - PHPDoc (phpDocumentor)
Perl - pod (родной формат)

Также комментариями снабжаются все артефакты - схемы баз данных, конфиги, скрипты ANT и Makefiles, XML файлы и т.д.

Без коментариев только ПО уровня "hellp world"

Всё остальное испещерено коментариями, т.к. из-за большого количества работы, через пару месяцев без них нужно будет тратить много времени на понимание кода.

Никак не могу себя приучить к комментариям.
комментирую только функции - что делают, что возращают

весь остальной код без комментариев.

Глупый вопрос на самом деле
Вам наврядли кто скажет нет

Цитата ("Kurilshik"):

Глупый вопрос на самом деле
Вам наврядли кто скажет нет

я же сказал

Ну почему же?
Хорошо спроектированная программа сама по себе достаточно самодокументированная вещь.
Кроме того, если брать аспект Win32/COM, то каждый метод или свойство может иметь свое описание. Если не лениться и заполнять это описание, то можно обойтись и без комментариев.
Скажем, в большинстве моих программ комментарии занимают не больше нескольких процентов.
Подробные комментарии присутствуют только когда изначально оговаривалось, что передаваться будет исходный код и он должен быть откомментирован.
Кстати, в этом случае комментарии всегда ставлю на английском.

Кстати, дополню пилотный пост
Если вы комментируете код, какой язык обычно используете?

Я, кстати, совершенно согласен, что коментарии нужны и полезны.
Просто необходимость приучить себя + лень дают такой результат.

Цитата:

Если вы комментируете код, какой язык обычно используете?

Если заказчик из России - то русский.
если заказчик - буржуй - то английский

Комментарии делаю для себя... потом некоторые оставляю которые может и заказчик заменить и отдаю... =)

Разрабатывал специально документацию по комментированию кода и введению проекта.
Так как иногда код, написанный одним программистом, задействован другим.
И чтоб не бегать и не спрашивать, что тут и как передается и не разбираться, тратя на это время, то тут помогает хорошее структурирование описание кода. К тому же и самому проще потом будет, когда заброшенный код придется использовать заново =))

А я делаю комменты не всего, ибо есть такие вещи, где комментарий должен быть больше чем сам код

Коментирую только функции. в последнее время, перестал коментировать вообще, ибо стремлюсь к тому, что бы, код был ясен и без коментариев.

Раньше, когда скрипты писались небольшие (не выше 300-500 строчек), не комментировал... разобраться после недели было сложновато, но всё же было лень писать.. теперь стараюсь комментировать ВСЁ, любую строчку, а например переменную $ua всегда сначало комментирую "//USER ARRAY - массив пользователя", стало намного легче потом добавлять код )))

Комментирую, разобраться и вспомнить что ты писал пару месяцев назад проблематично... тем более если разбираешься уже не ты...

Комментирую очень (очень) редко. в основном код-код-код. заказчики не просят, а мне и так все понятно. что чужой код, что свой. читается как книга написаная большой кирилицей

Обязательно. Иногда через полгода надо изменить функциональность, а ничего понять не возможно Стараюсь по максимуму коментировать, чтобы потом кто-нить не тратил время на разбор моего кода.
Хотя стремлюсь к тому, чтобы код читался легко и без проблем, но как-то вошло уже привычку

Комментирую только самое необходимое! Время жаль на это тратить : ) Лучше пива с друзьями попью, да и просто лень! Стараюсь просто удобно структкировать код...

В основном DOxygen...

В коде комментарии есть только в самых важных местах