Во время секса:
Она: я хочу, чтобы ты сделал мне больно!
Он: ты вливаешь ветку другого разработчика, а там 124 конфликта…
Она: погоди-ка, что?
Он: открываешь его код, а там переменные транслитом и ни одного комментария…
Она: СТОП!
Она: я хочу, чтобы ты сделал мне больно!
Он: ты вливаешь ветку другого разработчика, а там 124 конфликта…
Она: погоди-ка, что?
Он: открываешь его код, а там переменные транслитом и ни одного комментария…
Она: СТОП!
и ни одного комментария…
Это положительный критерий. В хорошем коде комментарии - редкость. Чаще всего они маркируют проблему.
Смотря что пишешь, например есть крутой кодер Тим Петерс пишет Python, оставляет не просто комментарии а целые абзацы текста, а иногда и целые страницы. Где весьма подробно поясняет почему так, а не иначе.
В рамках парадигмы ООП можно (и нужно) писать без комментариев. Почему так - отлично описано в книге "Чистый код" Мартина. Если кратко - называй объекты и классы существительными, функции/методы - глаголами, жестко разделяй ответственность - и будет тебе счастье без всяких комментариев.
Вы не о тех комментариях, как имя класса поможет узнать почему выбранно именно это решение, а не десяток других. Если не ошибаюсь в исходниках питона есть много текста про тимсорт сортировку, почему именно она, а не то как она работает это из кода ясно.
как имя класса поможет узнать почему выбранно именно это решение, а не десяток других.
А это нужно? Вот есть решение - оно или работает, или нет. В первом случае без разницы, почему оно работает. Во-втором - его овсе равно нужно переделывать. Если это устоявшийся алгоритм или шаблон - его название должно быть вынесено в имя класса. А читать про него нужно на сторонних ресурсах.
Преподобный Тимоти Петерс, американский сотрудник гуманитарной помощи, проживающий в Сеуле, Южная Корея, управляет Комиссией по оказанию помощи Корее и широко считается одним из самых заметных защитников прав человека в Северной Корее
IT-юмор
5.6K поста52.5K подписчиков
Правила сообщества
Не публикуем посты:
1) с большим количеством мата
2) с просьбами о помощи
3) не относящиеся к IT-юмору