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