Size: a a a

2020 May 11

A

Aikidos in Go-go!
Aikidos
Поэтому, кстати, всякие пакеты, stdlib'ы и т.п.. комментируют. Или там тоже плохой код?
^ вот я задал вопрос. Там комментируют максимально понятный код. Он плохой?
источник

D🦆

Dmitry 🦆 in Go-go!
Aikidos
апелляция к авторитету распространенная логическая ошибка
К авторитету пришли только после поиска источника о некачественных комментариях
источник

D🦆

Dmitry 🦆 in Go-go!
Aikidos
^ вот я задал вопрос. Там комментируют максимально понятный код. Он плохой?
не за компом, не могу посмотреть
источник

D🦆

Dmitry 🦆 in Go-go!
очевидно, что если прокомментировано качественно - хороший
источник

D🦆

Dmitry 🦆 in Go-go!
а если отписки чтобы линтер не ругался - плохой
источник

U

U2227 in Go-go!
Ну линтер можно и отключить, если не хочешь документацию писать  ;)
источник

A

Aikidos in Go-go!
Dmitry 🦆
а если отписки чтобы линтер не ругался - плохой
Так и есть. Я сам встречал просто заглушки. Слэши и всё.
источник

A

Aikidos in Go-go!
Тут претензии обоснованы
источник

U

U2227 in Go-go!
Aikidos
Так и есть. Я сам встречал просто заглушки. Слэши и всё.
Есть же еще сгенеренный код  :)
источник

A

Aikidos in Go-go!
U2227
Есть же еще сгенеренный код  :)
обычно в линтерах делают возможность отключить проверку для сген. кода
источник

A

Aikidos in Go-go!
чтобы не ругался на комменты)
источник

U

U2227 in Go-go!
Ну да или в шаблон впилить //nolint  :)
источник

D🦆

Dmitry 🦆 in Go-go!
Например у нас есть сущность (ентити) с нормальным названием, у полей нормальные понятные названия. Считаю, что комментарии снизят качество такого кода.
источник

D🦆

Dmitry 🦆 in Go-go!
Т.к. будет просто копипаста с добавлением пробелов вместо кемел кейса
источник

C

Calculon in Go-go!
Dmitry 🦆
Например у нас есть сущность (ентити) с нормальным названием, у полей нормальные понятные названия. Считаю, что комментарии снизят качество такого кода.
линтер так не считает
источник

D🦆

Dmitry 🦆 in Go-go!
именно
источник

C

Calculon in Go-go!
Готов терпеть его упрёки? :D
источник

C

Calculon in Go-go!
Лично меня бесят варнинги, поэтому я комментирую
источник

U

U2227 in Go-go!
Dmitry 🦆
Например у нас есть сущность (ентити) с нормальным названием, у полей нормальные понятные названия. Считаю, что комментарии снизят качество такого кода.
Всегда можно описать зачем эта сущность нужна, как её использовать и тд
источник

D🦆

Dmitry 🦆 in Go-go!
А потом это искусственно придуманное очевидное описание (предположим именно такой случай) еще и поддерживать.
источник