Здравствуйте, vsb, Вы писали:

vsb>Комментарии лучше не писать. Это первейший признак плохого кода. Бывают исключения, но редко. Хочешь написать комментарий — вынеси код в функцию с названим, отражающим то, что ты хотел написать в комментарии.
Вот эта фраза зацепила. Мне кажется, это неверное мнение.
Писать комментарии, которые могут быть записаны в названии функции, действительно, не следует. Но это не значит, что их не нужно писать вообще.
Например, могут быть комментарии:
— почему в этом месте кода используется именно этот алгоритм, а не другой, очевидный
— почему делаются нетривиальные вещи (например, обход бага библиотеки)
— отсылка к стандарту, который предписывает дклать именно так
да и многое другое. Что это всё в имена переменных записывать? Или писать отдельный документ с комментариями к коду?

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