Семь принципов разработки, от которых нам пришлось отказаться

Первый пример.

От простого будем идти к сложному.

Много лет подряд я считал, что-- я считал, мы считали, что код должен быть читаемый.

Должно быть понятно не мне, автору, а читателю, который будет читать то, что я пишу.

Поэтому код нужно что? Комментировать, код нужно объяснять.

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

В эпоху LLM, в эпоху агентов никто код читать не будет.

Человек больше код не читает, никому не интересны ваши комментарии и никому не интерес, не интересен в принципе ваш код.

Кроме робота, кроме агента.

А робот путается, когда видит в комментариях одно, а в исходном коде другое.

И роботу комментарии не нужны, ему не нужно разжевывать, что вы сделали.

Он, глядя на код, понимает прекрасно, что происходит.

Мы не понимаем.

Я не понимаю.

Он понимает.

Поэтому комментарии мешают.

Как показывают исследования, они могут даже путать.

Хотя исследования двух, двухлетней давности, но сейчас, я думаю, ситуация еще хуже.

Чем больше пишем комментариев, тем делаем хуже нам.

То есть сейчас важно, чтобы код был не читаемый, а код был максимально минимальный, упрощенный, точный.

Он должен только то делать, что он должен делать без лишних слов.

Приведу вам пример.

Мы в наших проектах запрещаем комментарии, э, скриптами на сборке.

В Haskell мы полностью запрещаем комментарии.

В JavaScript полностью запрещаем любые комментарии, какие бы то ни было.