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


 

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

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

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

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

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

*/

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

 
« Предыдущая статья