Не пишите комментарии к коду!
Вступление Доброго времени суток, Хабражитель. Сразу хочу оговорится, что название не означает, что я буду призывать не писать комментарии никогда, любая крайность в этом мире скорее всего ущербна. Я лишь хочу сказать, что желание написать комментарий в каком-либо месте почти всегда свидетельствует о более важной проблеме в коде, разобравшись с которой необходимость в комментировании пропадет. Перед началом еще хочу сказать, что примеры буду приводить с использованием Java, а небольшой отрывок кода (с маленьким дополнением) взят из проекта описанного тут. Для понимания проблемы обратимся к Вики, а после перейдем к примерам: Коммента́рии — пояснения к исходному тексту программы, находящиеся непосредственно внутри комментируемого кода.Читать дальше →
