Комментарии в коде

Коротко: Комментарии — текст в исходном коде, который компьютер игнорирует. Они объясняют «почему», а не «что».

Подробнее: Хороший код в основном объясняет себя понятными именами. Комментарии добавляют то, чего в коде не видно: причины, допущения, подводные камни, ссылки.