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