Распространенная ситуация при программинге, как быть? Быстродействие vs Лаконичность - страница 5

 
Vinin:

По собственному опыту. Комментарии нужны. В студенчестве ( а закончил 25 лет назад институт) делал работу. Занимала около 100-120 распечатанных листов (листинг). Сколько там было строк. Уже и не упомню.

Под заказ как раз нужен прибранный код и с комментариями.  Через полгода не вспомнишь что и кому делал (точнее как). Если придется дорабатывать, то придется знакомиться со своим кодом с нуля.

Совершенно согласен. Краткость - искра таланта:) Вот что пишет Роберт Мартин в своей книги "Чистый код" на счет длины функции:

Роберт Мартин - Чистый код. Функции, стр. 58 

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

Про комментарии этого же автора:

Роберт Мартин - Чистый код. Комментарии, стр. 80