Comments on: Немного о видах комментариев в коде

By: vadim

vadim — Thu, 01 Nov 2007 11:52:08 +0000

Оно и видно что не видел :)

By: Chabster

Chabster — Thu, 01 Nov 2007 11:35:34 +0000

А можно не рефакторить, а написать нормальные коментарии. Цель одна и та же – представить код на более абстрактно-понятном уровне.

Кент пишет полную чушь. А следуют его бредовым принципам исключительно из-за популярности автора. И ХР – полная х***я. А книга его про TDD – редкостный отстой. Хуже не видел.

By: vadim

vadim — Thu, 01 Nov 2007 11:10:19 +0000

За отсутствие каментов в больших методах со сложными вычислениями я бы открутил башку

А я бы за большие методы со сложными вычислениями открутил башку.
Любой, абсолютно любой, длинный метод можно отрефакторить так, что он станет простым и понятным. В случае нежелания делать рефакторинг, можно разбить твои вычисления структурными комментариями.

Про TDD почитай у Бэка, много нового узнаешь. Для начала :)

By: Chabster

Chabster — Thu, 01 Nov 2007 11:04:54 +0000

Жавадок – для кода, который заведомо корректный и изменению не подлежит (как правило – API).
Весь остальной код должен принудительно комментироваться. За отсутствие каментов в больших методах со сложными вычислениями я бы открутил башку.
“настоящие TDD-шники комментарии не пишут в принципе” и, видимо, пишут в одиночку или с соседом по унитазу…

By: vadim

vadim — Wed, 31 Oct 2007 18:50:31 +0000

Chabster, не перекручивай!
Где в статье написано “без жавадок”? А где написано “без документации”?

Кстати настоящие TDD-шники комментарии не пишут в принципе :)
А твои “миллионы строк распределенного кода” – это частный случай, для которых каждая строка комментария на вес золота.
Это же касается legacy-кода.

By: Chabster

Chabster — Wed, 31 Oct 2007 18:39:26 +0000

Вайт, почитай Макконелла. Для начала.
А второе – попробуй использовать незнакомое АПИ без документации. Я, естественно, опять клоню к миллионам строк распределенного кода. Но ты попробуй просто апи без жавадок.

By: vadim

vadim — Wed, 31 Oct 2007 15:51:18 +0000

ЗАЧЕМ и ПОЧЕМУ

Это как раз те комментарии, от каких стоит избавляться. Хотя действительно – такие существуют и порой приносят пользу.

By: Скакунов Александр

Скакунов Александр — Wed, 31 Oct 2007 13:04:25 +0000

А я пишу комменты для себя.

By: Andy

Andy — Wed, 31 Oct 2007 12:45:32 +0000

Бывают еще и комментарии ЗАЧЕМ и ПОЧЕМУ код написан именно таким образом… Вот они как раз и пишутся чаще всего. А если не пишутся, когда надо, то лентяев нагибают и они все равно пишутся…