Почему жалоба оказывается рядом с функцией

Исходный код — не только набор команд для компьютера. В нём есть комментарии: текст, который программа обычно игнорирует, но который помогает людям понять, зачем устроен участок кода и какие ограничения нельзя случайно нарушить. Именно рядом с такой заметкой разработчик может оставить и личную реакцию на решение, принятое выше по цепочке.

Это место кажется естественным: спорное требование часто влияет на конкретную функцию. Например, код приходится усложнить ради срока, совместимости или правила, которое автор считает неудачным. Комментарий может одновременно объяснять обходной путь следующему программисту и выражать раздражение по поводу того, почему этот путь вообще понадобился.

Как такие заметки переживают автора

Код постоянно меняют и передают между людьми. Комментарий, оставленный в одном из таких изменений, может годами попадать в новые версии: его не удаляют, потому что он всё ещё выглядит частью технического контекста, или просто не замечают при переделке соседнего участка. Системы контроля версий сохраняют историю правок, поэтому даже удалённая заметка может остаться в старых версиях проекта.

У комментария есть и практическая цена. Поскольку он не влияет на работу программы напрямую, язвительность может казаться безобидной, но этот текст увидят коллеги, ревьюеры, а иногда и люди за пределами команды, если код станет доступен публично. Поэтому одна строка способна пережить рабочий конфликт куда дольше, чем сам спор — и превратить мимолётное недовольство в часть истории проекта.