Вы согласны, что хороший код не нуждается в комментариях?

Нет

нет, не согласен, тк у нас могут быть даже разные представления о хорошем коде

нет

😁

А, ну тогда, да, спорить не о чем особо. По мне комментарии - это в большинстве признание программиста в невозможности написать качественный код.

почему Вы так считаете?

Ну, во-первых, так считать меня научил Мартин. Во-вторых сравните два куска кода:
employee_name = 'Boris' и a = 'Boris'. В первом случае комментарии не нужны, во втором - не помешали бы.

А описание аргументов функции считаются комментариями или нет?

Нет, это докстринги.

Это хорошо и приятно.

Вот и разобрались

ок. Но, тогда вопрос в соотношении кода из первого примера и кода из второго примера в реальной жизни с дедлайнами, проектами на 2-3 языках, которые крутятся 24/7 в своих докеробразах, подают, поднимают друг друга, зависят от репозитория, который оплачивает третья сторона, dom сайтов конкурентов, которые не любят халявшиков, сторонних компаний, которые время от времени меняют свои API и прочих прелестей. и да, архитектора этого схантила другая компания.😊

Есть много полезных комментариев, типа комментариев описывающих какие-то хитрости бизнес логики, какие-то сложные логические конструкции или пограничные условия. Короче, не должно быть комментариев отвечающих на вопрос "Что здесь происходит" - на этот вопрос должен код ответить. Скорее вопрос должен быть "Почему"?

на 6м курсе "финальный проект" нет кнопки "доступна финансовая помощь". это норма?

На самом деле, я думаю мы имеем в виду одно и тоже)

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

Ненене

Речь шла не о "от комментария может быть вред", а об "комментарии означают плохой код"