Некоторые причины, по которым некоторые разработчики считают, что комментарии вредны для качества кода:

• Комментарии могут устареть. 5 При редактировании кода программист, как правило, уже разбирается в нём и ему комментарии не нужны. 1 Поэтому часто он забывает о том, что их тоже надо поддерживать в актуальном состоянии. 1 В результате с течением времени комментарии становятся оторванными от кода и могут вводить в заблуждение нового разработчика. 1
• Комментарии могут скрывать низкое качество кода. 2 Если при написании модуля разработчик видит, что код получился корявым, то он может решить, что вряд ли кто поймёт его логику. 2 В таком случае комментарии только усложнят восприятие кода. 2

Однако стоит отметить, что мнение о вреде комментариев для качества кода не является однозначным и зависит от конкретной ситуации.