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