Раньше я очень много комментировал в своем коде. Откомменчивал просто всё, практически каждую строчку.
Обязательно каждую переменную, у каждой процедуры/функции (речь идет о delphi) - вообщем захламлял как надо! Вот пример (не выдуманный):
Ёмана... Сейчас смотрю на это как на какое-то безумие. С другой стороны плохой опыт это тоже опыт. Хорошо что сейчас все по другому, что я дошел все-таки до осознания что если нужен комментарий - значит ты написал плохой код.
Конечно, с этим не согласятся некоторые старые пердуны, которые как привыкли ебашить комментами с 80-х, так и делают и "зачем же что-то менять?!" Да срать я хотел, нафига кого-то переубеждать. Ну да, я согласен, что наверняка бывают ситуации когда без объяснения не обойтись. Но это, блин, единичный случай в проектах со сложной логикой. А когда ты начинаешь писать свою маленькую игрушку и на 10 строк кода 10 строк комментариев - что-то тут не так.
Хотел порекомендовать статью на хабре про это. Нормально написаны минусы закомменчивания: http://habrahabr.ru/company/enterra/blog/182574/
Обязательно каждую переменную, у каждой процедуры/функции (речь идет о delphi) - вообщем захламлял как надо! Вот пример (не выдуманный):
name : string[13]; // Ну собственно имяname - это имя? Да ладно?! Спасибо, чувак, теперь я понял для чего нужна эта переменная с таким непонятным именем!
Ёмана... Сейчас смотрю на это как на какое-то безумие. С другой стороны плохой опыт это тоже опыт. Хорошо что сейчас все по другому, что я дошел все-таки до осознания что если нужен комментарий - значит ты написал плохой код.
Конечно, с этим не согласятся некоторые старые пердуны, которые как привыкли ебашить комментами с 80-х, так и делают и "зачем же что-то менять?!" Да срать я хотел, нафига кого-то переубеждать. Ну да, я согласен, что наверняка бывают ситуации когда без объяснения не обойтись. Но это, блин, единичный случай в проектах со сложной логикой. А когда ты начинаешь писать свою маленькую игрушку и на 10 строк кода 10 строк комментариев - что-то тут не так.
Хотел порекомендовать статью на хабре про это. Нормально написаны минусы закомменчивания: http://habrahabr.ru/company/enterra/blog/182574/