Правила программирования на С и С++. Главы 1-6 - Комментарий не должен подтверждать очевидное

ОГЛАВЛЕНИЕ

 

26. Комментарий не должен подтверждать очевидное.

Начинающие программировать на С склонны попадать в эту ловушку. Избегайте явно нелепых случаев типа:

++x; // увеличить xно мне также не нравятся комментарии типа: /*-------------------------------------------

* Определения глобальных переменных:

*-------------------------------------------

*/

Любой средний программист знает, как выглядит определение.