Избыточный комментарий

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

counter += 1;  # увеличиваем счётчик на 1

Или другой пример — встроенная документация docstring, которая содержит не больше полезной информации, чем простая сигнатура функции:

def count_characters_in_string(string):
     """Считает количество символов в строке"""

Лишние комментарии нагромождают код. Когда меняешь код, приходится менять и комментарии.

Комментарии должны говорить то, что не может сказать сам код. Если комментарий можно заменить более удачным названием — сделайте это. Если комментарий поясняет сложное выражение — разбейте это выражение на части, введите промежуточные переменные с говорящими названиями.