Комментить код — почти всегда плохо же. Как писал Роберт Мартин, если ты оставляешь комментарий в коде, то ты, скорее-всего, проиграл (за некоторыми редкими исключениями). Код должен говорить сам за себя. Кек)
красивая фраза, но в жизни не работает никогда
методы < 20 строк + аннотации + название коммита == комменты не нужны
Код скажет тебе что он делает (и то не всегда), но не объяснит зачем, особенно если сложная бизнес-логика.
Ну, если писать императивно, то ничего не скажет и не объяснит, конечно. Всегда надо повышать уровень абстракции )
Увы, это не работает, нужны комментарии. Даже развернутые названия функций типа do_some_weird_but_specific_shit() не помогают.
Комментарий недоступен
-
Комментить код — почти всегда плохо же. Как писал Роберт Мартин, если ты оставляешь комментарий в коде, то ты, скорее-всего, проиграл (за некоторыми редкими исключениями).
Код должен говорить сам за себя. Кек)
красивая фраза, но в жизни не работает никогда
методы < 20 строк
+ аннотации
+ название коммита
==
комменты не нужны
Код скажет тебе что он делает (и то не всегда), но не объяснит зачем, особенно если сложная бизнес-логика.
Ну, если писать императивно, то ничего не скажет и не объяснит, конечно. Всегда надо повышать уровень абстракции )
Увы, это не работает, нужны комментарии. Даже развернутые названия функций типа do_some_weird_but_specific_shit() не помогают.
Комментарий недоступен
-