"মজার মন্তব্য" একটি খারাপ অভ্যাস বা না? [বন্ধ]


37

আমি আপনাকে জিজ্ঞাসা করতে চাই উত্স ডকুমেন্টেশনে কিছু "ইস্টার ডিম" যুক্ত করা পেশাদারিত্বহীন কিনা। সম্ভবত আপনি সোর্স ডকুমেন্টেশনে মজার মন্তব্যের জন্য স্ট্যাকওভারফ্লো পোলটি পড়েছেন এবং আমার কাজের সময় আমি ব্যক্তিগতভাবে পাবলিক এপিআই ডকুমেন্টেশনে মজার (বা না) স্টাফ সহ এই জাতীয় অনেকগুলি হোঁচট খেয়েছি (উদাহরণস্বরূপ এই দুর্বল BZZZTT !! 1! জিনিস) অ্যান্ড্রয়েড পাবলিক ডকুমেন্টেশনে, আমি কমপক্ষে আরও এক ডজন আরও উদাহরণ দিতে পারি)।

আমি নিজের পক্ষে চূড়ান্ত মতামতে আসতে পারি না, কারণ আমার নিজের দ্বারা যুক্তিযুক্ত বিরোধিতা রয়েছে।

প্রো যুক্তি:

  • এটি কাউকে উত্সাহিত করতে এবং তার দিনটিকে মজাদার / আরও উত্পাদনশীল করে তুলতে পারে। উত্স কোডের প্রধান অংশটি যেভাবেই হোক মন্তব্য করার প্রয়োজন নেই (যদি প্রকল্পটি সঠিকভাবে করা হয়), কারণ নির্দিষ্ট পদ্ধতিটি (উদাহরণস্বরূপ) স্ব-বর্ণনামূলক, বা যদি এটি অদ্ভুত ক্র্যাপি কোডের একটি গাদা হয়, এটি করতে পারে না অর্থপূর্ণ উপায়ে ব্যাখ্যা করুন, সুতরাং একটি মজার রসিকতা আপনাকে ডক থেকে প্রাপ্ত সম্ভাব্য তথ্যের ক্ষতি করে না।

কনস যুক্তি:

  • যদি আপনি খুব ঘনীভূত / হতাশ হন তবে আপনার সর্বশেষ জিনিসটি হ'ল কারও মূর্খ রসিকতা, ডকুমেন্টেড কোড অংশ সম্পর্কে আপনার প্রয়োজনীয় তথ্য দেওয়ার পরিবর্তে এটি আপনাকে আরও হতাশ করতে পারে। এবং প্রত্যেকে যদি এটি করা শুরু করে তবে ডকুমেন্টেশনটি কেমন হবে তার ধারণাটি ভয়ঙ্কর। এছাড়াও যে লোকটি রসিকতাটি লেখেন কেবল সে ব্যক্তিই মনে করতে পারে যে এটি মজাদার / আকর্ষণীয় / এটি পড়ার জন্য সময় নষ্ট করা উপযুক্ত।

আপনি কি মনে করেন?


দয়া করে সাইটের FAQ এবং প্রশ্ন জিজ্ঞাসার গাইডলাইন পড়ুন। এই প্রশ্নটি সত্যিই সেই নির্দেশিকাগুলি পূরণ করে না।
ওয়াল্টার

8
@ ওয়াল্টার: এটি প্রায় প্রোগ্রামারস.স্ট্যাকেক্সেঞ্জঞ্জ / প্রশ্নগুলি / 9০৯২২/২ এর মতোই প্রশ্ন , তবে এক মাস আগে জিজ্ঞাসা করা, অশ্লীল মন্তব্যের পরিবর্তে মজার মন্তব্যের জন্য এবং লিঙ্কযুক্ত প্রশ্নটি বন্ধ করা হয়নি। আমি আপনার সাথে বিতর্ক করতে সময় নষ্ট করব না যে এই প্রশ্নটি FAQ এর সাথে মিলিত হয় এবং কোড লেখার সময় এটি সেরা (ভাল) অনুশীলনের সাথে সম্পর্কিত।
কেউ

2
7 ভোট, এই প্রশ্নটি স্পষ্টভাবে চেয়েছিলেন। ব্যক্তিগতভাবে আমি করি না যে আপনি "কন" দ্বারা আমার কাছে বহুবার উল্লেখ করা হয়েছে তবে আমি "প্রো" এর পক্ষে যুক্তিগুলি দেখতে পাচ্ছি তাই ফলাফলটি কী হবে তা জানতে আগ্রহী। (সবচেয়ে খারাপ আমি বিটিডব্লিউর মুখোমুখি হয়েছি একজন প্রোগ্রামার যিনি ভেবেছিলেন যে বিবি বন্দুকের একটি বিড়ালছানাটির সাথে একটি বিড়ালছানাটির দিকে ইঙ্গিত করে একটি "হাস্যকর" ছবি অবশ্যই আমাদের সমস্ত দেব সার্ভারের হোম পৃষ্ঠায় থাকতে হবে। দীর্ঘশ্বাস ...)
জেমস

@ সাম্বোডি - আপনার একটি বক্তব্য রয়েছে, তবে মজার মন্তব্যগুলি আপনাকে হয়রানি বা খারাপতর করার সম্ভাবনা নয়, হয়রানির মামলাতে সাপেক্ষে। আমি অন্য প্রশ্নটি বন্ধ করার বিষয়টি বিবেচনা করব (এটি পোস্ট করার পরে আমার ঠিক ছিল যে তা নিশ্চিত নয়)।
JeffO

1
আমি সম্মত হই যে এই পোস্টটি আবার খোলা উচিত, যদিও আমি ভোট দিতে পারি না কারণ আমার কাছে প্রতিনিধি নেই। প্রোগ্রামারগুলিকে এসও থেকে পৃথক করার পুরো বিষয়টিটি এই জাতীয় প্রশ্নের জন্য। এই প্রশ্নের জন্য 22 টি ভোট সহ, এটি সম্প্রদায়টি পরিষ্কারভাবে চেয়েছে।
রোবশপ 25'11

উত্তর:


12

আমি মনে করি যে মজার মন্তব্যগুলি সময় নষ্ট করে - লেখার সময় নষ্ট করে, পড়ার সময় নষ্ট করে দেয়, সময় নষ্ট করে আপনার সহকর্মীদের কাছে মজার মন্তব্যটি দেখায় (প্রায় সর্বদা) নিছক বিশৃঙ্খলা হয় এবং এই জাতীয় কিছু।

তবে ... আসলে প্রতিদিন কেউই প্রতিদিন 100% এ কাজ করে না (এটি করা সাইটগুলি যদি আমরা করতাম তবে খালি হবে) এবং আসল রসিকতা দিনটি ভেঙে দেয় এবং মনোবল বজায় রাখতে সহায়তা করে।

আমি এখনও এর বিপরীতে ভোট দিতে পারি কারণ আমি পড়েছি এমন প্রতিটি 'মজার' মন্তব্যটি সম্ভবত সেই সময় হাসিখুশি হতে পারে - তবে আমি এখনও দেখতে পেলাম না যে আসলেই মজার, বেশিরভাগ নিছক বিস্মিত বা গভীরভাবে ডাউন -joke।

মজার মন্তব্য যদি মজার হয় তবে তা আমার মন পরিবর্তন করবে। তবে একবার আপনি কৌতুককে উত্সাহিত করার পরে, আপনি কি শপথ করা বা অপমান বা দূষিত হওয়ার বিষয়ে উত্সাহিত করেন?


5
+1 আপনি কেবল তখন সেই মন্তব্যগুলি পড়েন যখন আপনাকে কোনও কিছু ঠিক করতে হবে এবং তখন সেগুলি কোনও তাত্পর্যপূর্ণ হবে না এবং আপনাকে বাগফিক্স করার সময় অবশ্যই বিষয়টি সম্পর্কে অন্য কোনও বিকাশকের 'চতুর রসিকতা' দেখার মুডে নেই। কৌতুক ভাবার বিষয়ে সময় ব্যয় করার পরিবর্তে, দয়া করে, পরিষ্কার কোডে কিছুটা সময় ব্যয় করুন, একটি ত্রুটি ফিক্স করুন ইত্যাদি Also এছাড়াও, কিছুটা রিফ্যাক্ট হয়ে গেলে 'জোক' দিয়ে কী ঘটে?
জানু_ভি

2
সুতরাং এটি ঠিক মেটাস্পেসে হাস্যরসের মতো: এটি আরও মজাদার হবে এবং আপনি যা করেন তা সব থেকে ভাল না।
ড্যান রে

1
+1 চালাক, যতক্ষণ না এটির কোনও ক্ষতি হয় না। ফেলে stop() //hammertimeস্টপ প্রতিটি উদাহরণের এ মজার নয়।
গ্লাসেন্ট

@ ব্লাসান্ট - এটি একটি আসল মজার মন্তব্য - তবে এটি পুনরাবৃত্তি 2 এ জ্বালাতন করবে এবং পরবর্তীকালে ক্রমবর্ধমান বিরক্ত হবে!
অমলভিন

মন্তব্যে হাস্যরসের অনুমতি দেওয়া পুরোপুরি গ্রহণযোগ্য। কেন ইতিমধ্যে একটি শুষ্ক শিল্প শুষ্ক এবং হাস্যকর? শপথ করা বা অপমান বা দূষিত হওয়ার অনুমতি দেওয়া সম্পূর্ণ ভিন্ন বিষয়। আমার অভিজ্ঞতা আপনার থেকে সম্পূর্ণ আলাদা ছিল। আমি অনেক সময় তথ্যবহুল মন্তব্য পড়ে মজা পেয়েছি যা মজার হাস্যরসের প্রদর্শন করে। এটি আমার দিনকে আরও ভাল করে তুলেছিল। কারও রসিকতায় স্বাদ পেতে কিছু বুদ্ধি লাগে তবে এটি যদি পরিপক্কতার সাথে করা যায় তবে তা চালিয়ে যান।
জেবেক

71

আমি মজার মন্তব্যের একটি বড় অনুরাগী

আপনার মন্তব্যে সর্বদা পেশাদার হওয়া উচিত তবে কিছু রসিকতা পাঠককে হত্যা করবে না।

বিশেষত পাঠক যদি আপনার দলের সদস্য হন।

আমি যা সবচেয়ে বেশি অপছন্দ করি তা হ'ল এমন বিকাশকারীরা যা তাদেরকে খুব গুরুত্ব সহকারে নেয়। আমি মনে করি আমাদের কাজের সাথে মজা করা উচিত, বা কাজের পক্ষে এটি লাভজনক নয়।


9
+1 "করতে পেশাগত কিন্তু মজার" এর জন্য
deworde

প্রোগ্রামিং নিজেই মজাদার :)
গোপী

2
@ শ্রী কুমার: দুর্ভাগ্যক্রমে, সবসময় না। :(
ববি

1
@ ববি: এটিকে মজাদার করার সিদ্ধান্ত নিন! যদি তারা আপনাকে না দেয়, তবে এটি আপনার প্রাপ্য কোনও সংস্থায় আনুন happiness

3
নিজেকে খুব বেশি গুরুত্বের সাথে না নেওয়ার জন্য +1।
JeffO

8

যদি এর অর্থ থাকে তবে মজাদার হতে ভাল। একটি মন্তব্যে মজাদার উপায়ে কিছু ব্যাখ্যা করা ভাল। তবে, যদি এটি কেবল মজার কিছু এবং মন্তব্য হিসাবে এর কোনও আসল মূল্য না থাকে তবে তা বিরক্তিকর। সর্বদা মনে রাখবেন যে মন্তব্যের কারণটি রক্ষণাবেক্ষণকে আরও দক্ষ করে তোলা। হাস্যরসের সাথে তার বিরোধ নেই, তবে যথাযথভাবে করা না পারলে।


একটি সমালোচনামূলক প্রোগ্রামের ত্রুটি পরিচালনা করার কোডটিতে একটি মন্তব্য রয়েছে: "জীবন একটি _ এবং তারপরে আপনি মারা যান।" ব্যাখ্যা শেষে। এটি মজাদার এবং এটি উপলব্ধি করে।
মাইকেল কে

1
@ মিশেল - আমার মনে হয় এটি অপব্যয় এটির একটি নিখুঁত উদাহরণ। এটি মজার বিষয় নয় (এটি একটি খুব পুরানো এবং ক্লান্ত বিবৃতিটির আর একটি পুনরাবৃত্তি) এবং মূল্যবোধের কিছুই যোগ করে না।
ব্রায়ান নোব্লাচ

8

কোড পড়ার জন্য বোঝানো হয় ... বহুবার।

শততম বলার পরে আপনি কয়টি রসিকতা জানেন যে মজার?


@ থরবজর্ন রাভন অ্যান্ডারসন: ডিলবার্ট কার্টুনগুলি কি আপনি আপনার ঘন প্রাচীরে মুদ্রণ করেন এবং পিন করেন? ;)

@ পিয়ার, যদি আপনি একটি একক Dilbert কোনও উত্স কোড মন্তব্য দেওয়ার জন্য উপযুক্ত খুঁজে পান তবে দয়া করে আমাকে জানান।


@ পিয়ার, আসলে আমি পোস্টারটিতে থাকা শব্দটিকে সীমাবদ্ধতার চেয়ে বেশি মনে করি এবং মজার নয়, তবে এটি অন্য একটি বিষয়। আপনার আর কত আছে?

@

7

মজার মন্তব্য দুর্দান্ত।

  • এটি আপনার আপাতদৃষ্টিতে বিরক্তিকর কোডকে একটি ইতিবাচক ধারণা দেয়।
  • আপনি যদি আপনার সময় সঠিকভাবে পান তবে এটি সাধারণ বিরক্তিকর মন্তব্যের চেয়ে অনেক বেশি ভাল ব্যাখ্যা করবে। এখানে 'সময়' দিয়ে আমি মন্তব্যটির নীচের কোডের সাথে প্রাসঙ্গিকতা বলতে চাইছি।
  • আপনার কোডটি অনেকেই মনে রাখবেন, কারণ আবেগগুলিকে (মানুষের) স্মৃতিতে আরও ভাল স্থান দেওয়া হয়। আপনি যদি ওপেন সোর্স প্রকল্পে আরও বেশি লোক আপনার সাথে কাজ করতে চান তবে এটি দুর্দান্ত কৌশল।
  • সাধারণত পর্যালোচনায় সহায়ক। এটি আপনার কোডকে অনেক বেশি বহনযোগ্য করে তোলে। অবশ্যই আপনার প্রথমে ভাল কোড লেখায় মনোনিবেশ করা উচিত। আমি যখন অনুভব করি যে তারা যখন কোড লিখবে সে সম্পর্কে আত্মবিশ্বাসী, মজার মন্তব্যগুলি কেবলমাত্র একটি পার্শ্ব প্রতিক্রিয়া।

এই লোকটির মতোই মজার হবেন না ;)


6

এখানে আমি সকালে দুপুরে একটি লিখেছিলাম ("ডিকিউ" আমার সংস্থার আদ্যক্ষর):

// 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 টা 2 মিনিটে হওয়ার সম্ভাবনা থাকে তবে আমি এটাকে একটি ভাল রসিকতা বলে মনে করি না - আপনার পরে কেউ যদি 2 লাইনের উত্সের জন্য মন্তব্যটি দেখতে চান তবে আপনাকে 6 লাইনের পাঠ্য পড়তে হবে। প্রবন্ধের 600 টি রেখাটি পড়ার মতো একই অনুপাত যা 200 লাইনের কোডকে ব্যাখ্যা করে
কেউ

5
ওহ, দক্ষতা উইন্ডো বাইরে ছিল। এই প্রকল্পটি ইতিমধ্যে আপনি যেমন জানেন তেমন একটি গুচ্ছ ছিল, সামান্য লিভিটি 2am মনোবলের দিকে দীর্ঘ এগিয়ে গেছে। আপনি যদি খেয়াল করেন যে, আমি এখানে কোডটি লিখছি তা অন্য কারও opিলে .ালাটির আশেপাশে কাজ করা, যা গত দুই সপ্তাহের ডেথ মার্চ সম্পর্কে যা ছিল তা প্রায় ছিল pretty আমি নিয়মিত অনুশীলন হিসাবে এই ধরণের জিনিসকে ক্ষমা করি না, তবে আমি স্বীকার করি যে আমি এটির সাথে খুব খুশি হয়েছিলাম।
ড্যান রে

সেই পরিস্থিতিতে আমিও খুব খুশি হব
কেউ

লাইন নম্বর রাখবেন না, তার পরিবর্তে "<যা কিছু> অনুসন্ধান করুন" ব্যবহার করুন যেখানে <W>> নিজেই একটি মন্তব্য।
ভিঙ্কো ভার্সালোভিক

3

আপনি যদি গ্রাহকের সামনে আপনার উত্স কোডটি পর্যালোচনা করছেন তবে আপনি কি বিব্রত হবেন?

বর্তমানের উত্তরগুলির কোনওটিই এটিকে আমলে নিয়েছে বলে মনে হয় না। কিছু গ্রাহকের কৌতুক অনুভূতি নেই এবং রসিকতাগুলি এমন একটি সূচক হিসাবে নেবে যে আপনি আপনার কাজটিকে গুরুত্বের সাথে নেন না। তারা অনুমান করবে যে আপনি নিজের কাজের প্রতি অসতর্ক are

মজার কোড মন্তব্যগুলি কখনও কখনও অযৌক্তিক এবং অনুপযুক্ত হতে পারে।


3

ইতিমধ্যে যা বলা হয়েছে তার বাইরে, আপনি যদি আন্তর্জাতিক দলে কাজ করছেন তবে আপনার বিদেশী সহকর্মীদের মধ্যে কেউ কেউ রসিকতা পাবেন না কারণ কিছু স্থানীয় সাংস্কৃতিক রেফারেন্স বা কিছু শব্দের খেলা যা কারও পক্ষে বোঝা যায় না যার জন্য ইংরেজি স্থানীয় ভাষা নয় । ওপেন সোর্স প্রকল্পগুলির জন্য একই জিনিস প্রযোজ্য।


2

যদি এটি দক্ষ হয় এবং পাঠকদের সময় নষ্ট না করে (উভয়ই পড়া / বোঝার ক্ষেত্রে) তবে আমি কিছুটা রসিকতা নিয়ে কোনও সমস্যা দেখছি না।


2

বাস্তব বিশ্বের কৌতুকের মতো, আপনি যদি এগুলি সর্বদা তৈরি করেন তবে এটি মজাদার নয়, উত্পাদনশীল নয় এবং পেশাদার নয়। তবে সমস্ত রসিকতার জন্য একটি সময় এবং জায়গা রয়েছে এবং কোডের একটি সময় এবং জায়গা রয়েছে। বাস্তব বিশ্বের মতোই, এটি জানে যে কোথায়, কখন এবং কীভাবে রসিকতা করবেন।


1

নির্ভর করে, কলেজে অ্যাসাইনমেন্টের জন্য, আমি প্রায় সবসময়ই মজার মন্তব্য করতাম, কারণ আমি জানতাম এটি কখনই ব্যবহৃত হবে না এবং এটি কেবল একটি হোমওয়ার্ক অ্যাসাইনমেন্ট।

আরও গুরুতর প্রকল্পগুলির জন্য, আমি এখনও সেগুলি এখানে এবং সেখানে ব্যবহার করব তবে এটি প্রচলিত নয়, যাতে এটি বিরক্তিকর বা বোঝা শক্ত হয়, মন্তব্যটির উদ্দেশ্যকে অস্বীকার করে।

আমার মনে আছে কিছুটা ওয়েব প্রোগ্রামিং করছিলাম, যেখানে আমাকে ব্রাউজারের অসুবিধাগুলি এবং অদ্ভুত গ্লিটস ডজ করতে হয়েছিল। এটি কখনও কখনও .jsফাইলগুলিতে ক্ষোভ এবং ঘৃণা পূর্ণ মন্তব্যে শেষ হয় ।

আমার থাম্বের মূল নিয়মটি হল: কোড বিভাগটি যা কিছুটা করে তা যদি স্পষ্ট হয় তবে মজার মন্তব্যগুলি চালু করুন!

কোডটি যদি এতটাই অস্পষ্ট এবং জাহান্নামের মতো অস্পষ্ট হয়ে থাকে (" ইনলাইন ক্লাস " এর মতো) তবে আমি মন্তব্যগুলি ব্যবহার করতে পারব আমি কয়েক দিনের মধ্যে নিজেকে বুঝতে পারব ...

আমাদের সাইট ব্যবহার করে, আপনি স্বীকার করেছেন যে আপনি আমাদের কুকি নীতি এবং গোপনীয়তা নীতিটি পড়েছেন এবং বুঝতে পেরেছেন ।
Licensed under cc by-sa 3.0 with attribution required.