> Твои знания давно устарели. Мода на "самодокументирующийся код" была модномолодежный десять лет назад.

Это не мода, это норма. Не надо выдавать желаемое за действительность.

Зачем писать комментарий если можно написать тест?
Если вы написали комментарий, а код вокруг него поменялся, что с ним делать?
Где надо писать комментарии, а где не надо писать комментарии? Как уловить эту тонкую грань?
Что делать если комментарий вроде есть, но он понятен только его автору и не вносит ясности?

Я склоняюсь к тому, что комментарии уместны только для публичных членов библиотек, а для внутреннего кода мы их запрещаем всегда.

И да, на моей практике не было ни одного случая, когда комментарий нельзя было убрать.

> ...обнаружили, что нельзя вместить в название функции полноценный комментарий со ссылкой на стандарт/патент/статью и описанием специфических условий и допущений и пришлось заново переписывать код, в котором не удалось разобраться как он работает.

Комментарии плохой код не исправляют, скорее наоборот, в плохом коде плохие комментарии.