[Moscow.pm] Комментарии

[Шогин Михаил]

>> Расскажите пожалуйста, как вы относитесь к комментариям в коде? Как вы
>> считаете, они помогают или мешают? А сами пишете?

Раньше не писали. Теперь пишем. 
Раньше было мнение, комментировать только сложные участки кода, провалилось.
Писать коменты не так затруднительно, главное привыкнуть.
Это как использование TDD, в начале писать тесты перед написанием кода
приводит к понижению производительности и срыву сроков.
Происходит подобное в силу возрастания кода и не умения писать тесты.
Далее производительность приходит в норму, потом повышается и в конце писать
код без тестов уже не можешь.
Тоже самое происходит и с коментами.

Не помню у кого читал, хотя это пишут многие авторы книг по agile software
development ( и не только ), 
"код мы пишем не для себя, а для людей" (с)

Михаил Шогин