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

Мне никогда не нравился откомментированный код.

Комментирование каждой строки сразу выдаёт начинающего программиста. А те комментарии, которые при написании были уместными все равно устаревают — код изменяется, комментарии обновить забывают, человеческий фактор. Лучший вариант, для компилируемых языков, self-explanatory код

Однажды не смог сделать оптимизацию в РеШарпере из-за комментария. Исправление предполагало переписывание логики к которой был написан очень длинный и основателеный комментарий. С одной стороны его стыдно удалить, а с другой — лень переписывать.

С переходом на AI программирование комментарии стали бесить вдвойне! Первые LLM комментировали каждую строку, словно только вчера начали программировать (так оно впрочем и было). Самые тупые и маленькие LLM стали уклоняться от написания кода через комментарии. Писали // TODO вместо реализации. Комменты стали признаком низкокачественного слопа

Приходилось говорить в промпте не писать комментарии, и упорно вычищать всё же написанные.

И оказалось зря. Если поддерживать код будет тоже агент — пусть пишет комменты. Для LLM куда меньше разницы между кодом и текстом комментариев, т.к. она видит токены. И комменты становятся дополнительным контекстом, с помощью которого нейронка сможет вспомнить бизнес-логику проекта, без полного повторного погружения в код. Вопрос с актуализацией комментариев тоже отпадает — нейросети подходят к этому ответственнее (они следуют алгоритму — поменял код, пройдись по референсам и актуализируй их, человек же — поменял код, скорей на прод)

Нейрокомментированный код конечно же неэстетичный. Но предназначен ли нейрокод для чтения и редактирования людьми?

@epeshkblog