ТОП 10 самых раздражающих факторов для программиста
Опубликовано 09.09.2008 | admin
10. Комментарии, которые объясняют “как”, но не объясняют “зачем”
Еще в институте, на курсе программирования, нас учили что код необходимо комментировать, и максимально полно. Всегда лучше иметь слишком много комментариев, чем слишком мало. К сожалению, данная рекомендация иногда перерастает совсем уж в паранойю — программист комментирует каждую строчку кода. Например:
$r = $n/2; // Устанавливаем $r равным $n поделенное пополам (more…)
// Цикл выполняется до тех пор пока $r — ($n/$r) больше $t
while (abs($r — ($n/$r)) > $t) {
$r = 0.5 * ($r + ($n/$r)); // Устанавливаем $r равное половине $r + ($n/$r)
}
