«Смешные комментарии» - плохая практика или нет? [закрыто]

37

Я хочу спросить вас, является ли добавление некоторых «пасхальных яиц» в исходную документацию непрофессиональным или нет. Возможно, вы читали опрос StackOverflow для забавных комментариев в исходной документации, и я лично сталкивался со многими такими вещами во время моей работы, включая забавные (или нет) вещи в общедоступной документации API (например, этот слабый BZZZTT !! 1! Вещь в публичной документации по Android я могу привести как минимум еще десяток примеров).

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

Pro аргумент:

  • Это может поднять настроение кому-то и сделать его / ее день более смешным / более продуктивным. Большую часть исходного кода не нужно комментировать в любом случае (если проект выполнен правильно), потому что конкретный метод (например) не требует пояснений, или если это куча странного дрянного кода, он не может объясняться осмысленно, чтобы забавная шутка не повредила возможной информации, которую вы можете получить из документа.

Минус аргумент:

  • Если вы очень сконцентрированы / разочарованы, последнее, что вам нужно, это чья-то глупая шутка, вместо того, чтобы дать вам необходимую информацию о документированной части кода, это может сделать вас еще более разочарованным. И идея о том, как будет выглядеть документация, если все начнут это делать, ужасна. Кроме того, парень, который пишет шутку, может быть единственным, кто думает, что это смешно / интересно / стоит тратить время на ее чтение.

Что вы думаете?

source-code кто-то
источник
Пожалуйста, ознакомьтесь с часто задаваемыми вопросами и инструкциями на сайте. Этот вопрос действительно не соответствует этим рекомендациям.
Уолтер
8
@Walter: это почти тот же вопрос, что и programmers.stackexchange.com/questions/50928/… , но для забавных комментариев вместо комментариев ненормативной лексики, и связанный вопрос не закрыт, заданный месяц назад. Я не буду тратить время на споры с вами о том, что этот вопрос соответствует FAQ, и что он связан с лучшими (хорошими) практиками при написании кода.
кто-то
2
7 голосов, этот вопрос явно востребован. Лично я не знаю, потому что меня разозлило «мошенничество», о котором ты упоминал много раз, но я вижу аргументы «за», поэтому мне любопытно, каков будет результат. (Худшее, с чем я столкнулся, кстати, был программист, который думал, что «смешная» фотография пистолета ВВ, указывающего на котенка с поднятыми лапами, должна быть на главной странице всех наших серверов разработки. Вздох ...)
Джеймс
@ Sombody - У вас есть точка зрения, но забавные комментарии вряд ли вас уволят или хуже, в зависимости от преследования иск. Я подумаю над тем, чтобы закрыть другой вопрос (не уверен, что имел это право, когда он был опубликован).
JeffO
1
Я согласен с тем, что этот пост следует открыть заново, хотя я не могу голосовать, потому что у меня нет представителя. Весь смысл отделять программистов от SO - это такие вопросы. Плюс с 22 голосами за этот вопрос, это явно разыскивается сообществом.
RoboShop

Ответы:

12

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

Но ... на самом деле никто не работает на 100% весь день каждый день (такие сайты были бы пустыми, если бы мы это делали), и подлинный юмор расстраивает день и помогает поддерживать моральный дух.

Я все равно проголосовал бы против этого просто потому, что каждый «забавный» комментарий, который я когда-либо читал, мог быть веселым в то время - но я еще не видел один действительно забавный комментарий, большинство просто озадачивают или глубоко в -joke.

Если бы забавные комментарии были действительно забавными, это изменило бы мое мнение. Но как только вы поощряете шутки, вы поощряете ругань, оскорбления или злобу?

amelvin
источник
5
+1 Вы читаете эти комментарии только тогда, когда вам нужно что-то исправить, и тогда они не имеют никакого смысла, а когда вы исправляете ошибки, вы, конечно же, не в настроении увидеть «умную шутку» другого разработчика по этому вопросу. Вместо того, чтобы тратить время на обдумывание шутки, потратьте некоторое время на более понятный код, исправьте ошибку и т. Д. Кроме того, что произойдет с «шуткой», если что-то подверглось рефакторингу?
Jan_V
2
Так что это как юмор в мясном пространстве: лучше быть смешным, а лучше не быть ВСЕМ, что вы делаете.
Дэн Рэй
1
+1 умный, пока это не навредит. Положить stop() //hammertimeна каждый случай остановки не смешно.
Glasnt
@glasnt - это действительно забавный комментарий, но он будет раздражать на итерации 2, а потом и дальше раздражать!
Амельвин
Допускать юмор в комментариях вполне приемлемо. Зачем делать уже сухую индустрию сухой И без юмора? Разрешение ругательств, оскорблений или злонамеренности - это совсем другое дело. Мой опыт полностью отличался от вашего. Я много раз посмеивался, читая информативные комментарии, которые демонстрировали остроумное чувство юмора. Это сделало мой день лучше. Нужно немного ума, чтобы быть со вкусом в своем юморе, но если это можно сделать со зрелостью, принесите его.
JBeck
71

Я большой поклонник забавных комментариев .

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

Особенно, если читатель является членом вашей команды.

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


источник
9
+1 за "Профессиональный, но смешной"
deworde
Программирование само по себе весело :)
Gopi
2
@ Шри Кумар: К сожалению, не всегда. :(
Бобби
1
@Bobby: примите решение сделать это весело! Если они не позволят тебе, иди принеси свое счастье в компанию, которая этого заслуживает.
3
+1 за то, что вы не относитесь к себе слишком серьезно.
JeffO
8

Если это имеет значение, хорошо быть смешным. Объяснять что-то в комментарии забавным способом - это хорошо. Однако, если это только что-то смешное и не содержит никакой реальной ценности в качестве комментария, это просто раздражает. Всегда имейте в виду, что причина комментариев - сделать обслуживание более эффективным. Юмор не должен конфликтовать с этим, но может, если не будет сделано должным образом.

Брайан Кноблаух
источник
В коде обработки ошибок критической программы есть комментарий: «Жизнь - это _, а потом ты умрешь». в конце объяснения. Это смешно и имеет смысл.
Майкл К
1
@ Майкл - Это прекрасный пример того, что я считаю пустой тратой. Это не смешно (будучи еще одним повторением очень старого и утомленного утверждения) и не добавляет ничего ценного.
Брайан Кноблаух
8

Код предназначен для чтения ... много раз.

Сколько вы знаете шуток, которые смешны после сотого рассказа?


источник
@ Thorbjørn Ravn Andersen: а как насчет карикатур Дилберта, которые ты печатаешь и прикрепляешь к своей стене? ;)
@Pierre, если вы найдете одного Дилберта, подходящего для добавления комментария к исходному коду, пожалуйста, дайте мне знать.
@ Thorbjørn Ravn Andersen: не Дилберт, но этот заслуживает места, которое требуется: i.imgur.com/tu7Fd.jpg
@Pierre, на самом деле, я считаю, что формулировка на этом плакате за гранью и не смешная, но это другой вопрос. Сколько еще у вас есть?
@ Thorbjørn Равн Андерсен: это единственный
7

Смешные комментарии - это здорово.

  • Это придаст позитивный вид вашему на первый взгляд скучному коду.
  • Если вы правильно рассчитали время. Это объясняет гораздо лучше, чем обычный скучный комментарий. Под «временем» здесь я подразумеваю отношение к коду под комментарием.
  • Ваш код запомнится многим, потому что эмоциям отводится лучшее место в (человеческой) памяти. Это отличный трюк, если вы хотите, чтобы с вами работало больше парней над проектом с открытым исходным кодом.
  • Вообще полезно в обзорах. Это делает ваш код намного более терпимым. Конечно, вы должны сначала сосредоточиться на написании хорошего кода. Я чувствую, когда кто-то уверен в коде, который они пишут, забавные комментарии - просто побочный эффект.

Только не будь смешным, как этот парень ;)

Reno
источник
6

Вот что я написал в два часа ночи («DQ» - инициалы моей компании):

// Twas the night before go-live and all through DQ
// the devs were all crying and yes, this means you.
// Keys had been saved with both hyphens and 'scores
// which left this programmer with finger pad sores.
// The solution I crafted, you'll likely find lacking:
// to OR them together with judicuous hacking.

$hyphenated = str_replace('_','-',$data_type_key);
$underscored = str_replace('-','_',$data_type_key);
// (and then see line 46)
Дэн Рэй
источник
3
Да, такие вещи, скорее всего, произойдут в 2 часа ночи, но я не думаю, что это хорошая шутка - кто-то после вас должен прочитать 6 строк текста, если он хочет увидеть комментарий для 2 строк источника. То же соотношение, что и при прочтении 600 строк эссе, объясняющего 200 строк кода
кто-то
5
О, эффективность была за окном. Этот проект уже был таким кластерным, вы знаете, что, немного легкомыслия прошло долгий путь к моральному состоянию в 2 часа ночи. Если вы заметили, код, который я пишу здесь, заключается в том, чтобы обойти чью-то неопрятность, которая была почти такой же, как и последние две недели марша смерти. Я не одобряю подобные вещи как обычную практику, но, признаюсь, мне она очень понравилась.
Дэн Рэй
В этой ситуации я тоже был бы очень рад
кто-то
Не вводите номера строк, используйте «поиск для <что угодно>» вместо того, где <все> само является комментарием.
Винко Врсалович
3

Если бы вы просматривали свой исходный код перед заказчиком, вы бы смутились?

Ни один из текущих ответов, кажется, не принимает это во внимание. Некоторые клиенты не имеют чувства юмора и воспримут шутки как показатель того, что вы не относитесь к своей работе серьезно. Они сделают вывод, что вы небрежны с вашей работой.

Смешные комментарии к коду иногда могут быть непрофессиональными и неуместными.

М. Дадли
источник
3

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

Vartec
источник
2

Если это эффективно и не тратит время читателей (в чтении / понимании), то я не вижу проблемы с небольшим количеством юмора.

jonners99
источник
2

Точно так же, как шутки в реальном мире, если вы делаете их постоянно, это не смешно, не продуктивно и не профессионально. Но есть время и место для всех шуток, и есть время и место в коде. Как и в реальном мире, он знает, где, когда и как пошутить.

Джеймс Бедфорд
источник
1

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

Для более серьезных проектов я бы все еще использовал их здесь и там, но не так широко, чтобы это раздражало или было трудно понять, бросая вызов цели комментария.

Я помню, как занимался веб-программированием, где мне приходилось избегать несовместимости браузеров и странных глюков. Иногда это заканчивалось комментариями, полными ярости и ненависти в .jsфайлах.

Мое основное правило: если совершенно очевидно, что делает этот раздел кода, включите смешные комментарии!

Если код настолько неясен и запутан, как ад (например, « встроенный класс »), я бы лучше использовал комментарии, которые я пойму сам через пару дней ...

Полемон
источник