Как стать автором
Обновить

Комментарии 24

Очень =)
Ник у тебя подходящий. Возмездишь им за меня?
1. Я сам не любитель обильно комментить код. Комментирую только заголовки процедур и фукций, либо блоков кода. Никогда не комментирую каждую строку.
2. Сам себе я не враг. )
3. Оставьте в покое мой ник, он не от слова NEMESIS.
Предлагаете каждую строчку кода комментировать? «Открываем файл», «закрываем файл» — это нормальные комментарии? Думаю что стоило раскрыть свою мысль или дать ссылку на статью из «Совершенного кода» Макконнелла.
Честно говоря не читал Макконнелла. Что касается каждой строчки, то лучше каждую строчку, чем практически полное отсутствие комментариев. Но это, конечно, ещё одна крайность. Всегда лучше делать «в меру».
Ну так прочитайте.

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

Лично я придерживаюсь принципа, что код, который не понятен без комментариев — плохой код. В некоторых случаях надо описывать алгоритм или суть кода, но таких случаев отнюдь не во всех областях программирования много.
Не указывайте мне, что делать. А то, что комментирование каждой строчки не выход — я написал выше.
Скопируйте сюда гиперссылку на «Совершенный код» Макконнелла.
Книга известная, гугл подскажет. У меня бумажный вариант.

Тем не менее: samouchka.net/2007/09/28/sovershennyjj_kod.html
Эту ссылку нашел за 1 минуту.
Дело в том, что у него известны пять книг («Software Estimation», «Code Complete», «Rapid Development», «Software Project Survival Guide» и «Professional Software Development»). По названиям сложно обрести стопроцентную уверенность в том, какую перевели и назвали «Совершенный код», так что пришлось вопрошать читавших.
Code Complete, очевидно.
Спасибо за ссылку, думаю будет интересно почитать.
Последние исследования подтверждают вашу правоту. Теже исследования показывают, что долгоживущие программисты за время своей карьеры тратят примерно 80000 часов на комментирование написанного ими кода.
Думаю меньше 80 000 часов =) Зато вероятность умереть от топора в голову, запущенного, казалось бы, незнакомым человеком, уменьшается в разы.
Если программисты будут на протяжении 9 лет комментировать свой код…
Кстати говоря, те же самые исследования доказали, что программисты, которые должным образом комментируют свой код, экономят до 20 лет жизни на поисках ошибок и нужных мест в коде.
Вы случаем не из Британских ученых? )
Что-то они в последнее время активизировались…
А программисты, которые пишут просто, понятно и без комментариев — на все 20.
О да =) Это точно
Вообще мне нравится фраза, к сожалению, не помню кто сказал:
«Пишите код так, как будто человек, который будет его поддерживать — серийный маньяк, который знает, где вы живете» :)
В точку =)
Стив Макконнелл
Зарегистрируйтесь на Хабре , чтобы оставить комментарий

Публикации

Истории