про комментарии

[yajohn]

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

Хорошо сказано. Жаль что любой проект-менеджер из ИТ услышав подобное либо не поймет сказанного, либо погибнет на месте от разрыва шаблона.

Comments

[http://users.livejournal.com/_linora_/]

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

[yajohn.livejournal.com]

> На самом деле сейчас все это интенсивно учат
Я считаю в процесс обучения айтишников надо ввести телесные наказания

> претворяют в жизнь
и это пугает

[http://users.livejournal.com/_linora_/]

Смотря какие айтишники. А вдруг они любят телесные наказания? :))

[oldin.livejournal.com]

Сильно напомнило "программирование сверху-вниз-наискосок", культовый текст начала 80-х. А если серьезно - это сказал самонадеянный мудак. Таких на пушечный выстрел нельзя подпускать к промышленному программированию.

[yajohn.livejournal.com]

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

[oldin.livejournal.com]

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

[mcsimkin.livejournal.com]

Насколько я помню источник (кажется, это из книжки Clean Code), то имелись в виду именно небольшие фрагменты. То есть, если вы пишете к 10 строчкам кода комментарий, то нужно эти 10 строчек вынести в отдельную функцию и речь идёт о комментариях " здесь мы делаем цикл от 3 до 5, так как элементы 0,1,2 никого не волнуют", а не о "согласно спецификации обязательна следующая последовательность действий: ..."

[http://users.livejournal.com/_linora_/]

Да!