Комментирование кода и продолжительность жизни

[@NYMEZIDE]

Достали, да?

[@COOL_ALMANAH]

Очень =)

[@COOL_ALMANAH]

Ник у тебя подходящий. Возмездишь им за меня?

[@NYMEZIDE]

1. Я сам не любитель обильно комментить код. Комментирую только заголовки процедур и фукций, либо блоков кода. Никогда не комментирую каждую строку.
2. Сам себе я не враг. )
3. Оставьте в покое мой ник, он не от слова NEMESIS.

[@remal]

Предлагаете каждую строчку кода комментировать? «Открываем файл», «закрываем файл» — это нормальные комментарии? Думаю что стоило раскрыть свою мысль или дать ссылку на статью из «Совершенного кода» Макконнелла.

[@COOL_ALMANAH]

Честно говоря не читал Макконнелла. Что касается каждой строчки, то лучше каждую строчку, чем практически полное отсутствие комментариев. Но это, конечно, ещё одна крайность. Всегда лучше делать «в меру».

[@remal]

Ну так прочитайте.

Комментирование каждой строчки — такое же зло, как и ужасный код.

Лично я придерживаюсь принципа, что код, который не понятен без комментариев — плохой код. В некоторых случаях надо описывать алгоритм или суть кода, но таких случаев отнюдь не во всех областях программирования много.

[@COOL_ALMANAH]

Не указывайте мне, что делать. А то, что комментирование каждой строчки не выход — я написал выше.

[@Mithgol]

Скопируйте сюда гиперссылку на «Совершенный код» Макконнелла.

[@remal]

Книга известная, гугл подскажет. У меня бумажный вариант.

Тем не менее: samouchka.net/2007/09/28/sovershennyjj_kod.html
Эту ссылку нашел за 1 минуту.

[@Mithgol]

Дело в том, что у него известны пять книг («Software Estimation», «Code Complete», «Rapid Development», «Software Project Survival Guide» и «Professional Software Development»). По названиям сложно обрести стопроцентную уверенность в том, какую перевели и назвали «Совершенный код», так что пришлось вопрошать читавших.

[@mitnlag]

Code Complete, очевидно.

[@COOL_ALMANAH]

Спасибо за ссылку, думаю будет интересно почитать.

[@flypigs]

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

[@COOL_ALMANAH]

Думаю меньше 80 000 часов =) Зато вероятность умереть от топора в голову, запущенного, казалось бы, незнакомым человеком, уменьшается в разы.

[@iShaman]

Если программисты будут на протяжении 9 лет комментировать свой код…

[@COOL_ALMANAH]

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

[@NYMEZIDE]

Вы случаем не из Британских ученых? )

[@mlurker]

Что-то они в последнее время активизировались…

[@mlurker]

А программисты, которые пишут просто, понятно и без комментариев — на все 20.

[@COOL_ALMANAH]

О да =) Это точно

[@ElenaHell]

Вообще мне нравится фраза, к сожалению, не помню кто сказал:
«Пишите код так, как будто человек, который будет его поддерживать — серийный маньяк, который знает, где вы живете» :)

[@COOL_ALMANAH]

В точку =)

[@maximw]

Стив Макконнелл