вующего кода (точнее, его отсутствия). Конечно, если вы действитель% но хотите повысить качество этого кода, то и комментарии нужно под% вергнуть переработке. Обнаружив комментарий, содержащий невер% ные сведения или ошибки, вы должны переписать его в процессе со% провождения данного кода.

Увидев предупреждающие флажки типа XXX, отнеситесь к ним со всем вниманием и осторожностью. Следите также за операторами вывода, которые закомментированы. Они явно указывают на то, что в этом мес% те кода были проблемы; изучите этот код особенно внимательно!

Помните о постепенной деградации комментариев. Если в коммента% рии сказано, что нечто определено в foo.c, нет никакой уверенности, что так оно и есть до сего дня. Всегда верьте коду и сомневайтесь в ком% ментариях.

Резюме

Главное – описать увиденное так, чтобы больше не повторяться.

Делмор Шварц

Мы пишем много комментариев. Это вызвано тем, что мы пишем мно% го кода. Важно научиться писать правильные комментарии, иначе наш код может потонуть под грузом бестолковых или устаревших комментариев.

Не нужно переоценивать значение комментариев; благодаря хорошим комментариям плохой код лучше не станет. Целью должно быть напи% сание самодокументируемого кода, для которого не требуются ника% кие комментарии.