smart code comments

[juan_gandhi]

http://www.quora.com/Computer-Science/What-is-the-smartest-comment-ever-in-a-block-of-code


// I dedicate all this code, all my work,
// to my wife, Darlene, who will
// have to support me and our three
// children and the dog once it gets
// released into the public.


// Magic. Do not touch.


// this comment included for the benefit of
// anyone grepping for swearwords: shit.


// I am not responsible of this code.
// They made me write it, against my will.


// no comments for you
// it was hard to write
// so it should be hard to read


/* Be a real daemon: fork myself and kill my parent */


// I don't understand how the following bit works,
// but it worked in the program I stole it from.


// Dear maintainer:
// Once you are done trying to 'optimize' this routine,
// and have realized what a terrible mistake that was,
// please increment the following counter as a warning
// to the next guy:
// total_hours_wasted_here = 42





Comments

[regent.livejournal.com]

Там какая-то фигня. Она требует мои секретные данные.

[spamsink.livejournal.com]

... for some values of "smart".
Комментарии, в которых встречается "I don't understand" в принципе не должны считаться smart.

[ivan-gandhi.livejournal.com]

У этого слова несколько различных значений.

[spamsink.livejournal.com]

Вот я и говорю, for some values of "smart", но в данном случае ни одного подобрать не могу.
И не showing quick intelligence, и не witty, и не saucy...

[sergiej.livejournal.com]

:)
я часто пишу "Do not touch." но не потому что это мейджик, а чтобы не трогали :))

[iron-bug.livejournal.com]

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

[victorgr.livejournal.com]

А система контроля версий не показывает кто, когда и с каким комментарием к коммиту? :)

[migmit.livejournal.com]

В нашей конторе поиск багов часто начинается с git blame "file" | grep "Vlad Mitsner"

[iron-bug.livejournal.com]

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

[victorgr.livejournal.com]

Тут как никогда в тему высказывание: Если бы программисты строили дома, то первый залетевший дятел разрушил бы цивилизацию.

[iron-bug.livejournal.com]

да нет. просто зависит от программистов. мы сейчас собрали команду профессионалов и нещадно увольняем тех, кто явно не тянет. но на ранних стадиях проекта там были проблемы, да.

[victorgr.livejournal.com]

По каким критериям "не тянут"? На что смотрите оценивая?

[iron-bug.livejournal.com]

код ревью, прежде всего. и активное желание работать и развиваться, что не менее важно. отсиживателей жопы с 8 до 5 сразу гоним, вежливо, но уверенно.
я по своему опыту даже из начального интервью с программистом вижу, выйдет из него толк или нет. но иногда, если программист молодой, то надо дать ему шанс попробовать свои силы и показать себя. тогда он либо покажет себя на практике, либо сольётся. обычно месяца хватает на то, чтобы понять, кто есть ху. но у нас тестовый срок - три месяца, для уточнения диагноза.

[iron-bug.livejournal.com]

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

[iron-bug.livejournal.com]

я недавно добавила коммент к коду: "на самом деле, максимум - это минимум. поэтому не трогать!" :)

[stanklimoff.livejournal.com]

// under duress

[migmit.livejournal.com]

long time; /* know C */

Порвало.

[anspa.livejournal.com]

В пакете Clipper версии Summer'87 в DBU.PRG было "this will work with soap". По-моему первый раз когда до меня дошло что в программах можно шутить.

[anspa.livejournal.com]

Мммм.. me stand corrected, found the original:

* with soap it's loaded