পুল রিকোয়েস্ট ও কোড রিভিউয়ের মেট্রিক
শেষ হওয়া কাজ সবচেয়ে বেশি অপেক্ষা করে রিভিউয়ে, তাই মাপুন একটি পরিবর্তন কেউ দেখার আগে কতক্ষণ পড়ে থাকে, তা কত বড়, এবং কত ঘন ঘন ফেরত আসে, আর প্রতিটি গতির সংখ্যাকে একটি গুণমানের সংকেতের সঙ্গে জোড় বাঁধুন, যাতে দ্রুততর মানে কখনও অযত্ন না হয়।
ভূমিকা ও প্রেক্ষাপট
একটি পুল রিকোয়েস্ট (pull request) হলো একটি ভার্সন কন্ট্রোল (version control) রিপোজিটরির এক শাখা থেকে আরেকটিতে একগুচ্ছ পরিবর্তন মার্জ করার প্রস্তাব, সঙ্গে তা মার্জ করা উচিত কি না তা নিয়ে আলাপ। অনেক দলে এটি "লেখক মনে করেন এটি কাজ করে" আর "দল একমত যে এটি পাঠানো যায়"-র মধ্যে আনুষ্ঠানিক গেট। আলাপটি কোড রিভিউ (code review)-এর একটি রূপ: লেখক ছাড়া অন্য একজন মানুষ পরিবর্তনটি পড়েন, প্রশ্ন করেন এবং তা অনুমোদন করেন বা সংশোধন চান। কিছু প্ল্যাটফর্ম একই জিনিসকে মার্জ রিকোয়েস্ট বলে; এই বিষয় দুটোর জন্যই "পুল রিকোয়েস্ট" ব্যবহার করে।
রিভিউ মাপার যোগ্য একটি সরল কারণে। ডেলিভারির প্রবাহ-দৃষ্টিতে কাজের আইটেম তার জীবনের বেশিরভাগ অপেক্ষায় কাটায়, আর রিভিউ সেই অপেক্ষাগুলোর একটি যা পুরোপুরি দলের নিয়ন্ত্রণের ভেতরে। ভাগ করা প্ল্যাটফর্মের বাধা বা বাইরের নির্ভরতার জন্য অন্য মানুষদের বদলাতে হয়। যে পুল রিকোয়েস্ট প্রথম দেখার জন্য দুই দিন অপেক্ষা করে তার জন্য শুধু দলের নিজের অভ্যাস বদলাতে হয়। এই বইয়ের প্রবাহের পরিমাপ (বিষয় 2.1, প্রবাহ পরিমাপ এবং বিষয় 2.2, লিড টাইম, সাইকল টাইম ও প্রবাহ-দক্ষতা দেখুন) সাধারণ শব্দভান্ডার দেয়। এই বিষয় চক্রের একটি ধাপে জুম করে এবং তাকে নিজস্ব যন্ত্র দেয়।
এজাইল ও ITIL-এর দৃষ্টিভঙ্গি এখানে কার্যকরভাবে মেলে। এজাইল দৃষ্টিতে রিভিউ একটি প্রতিক্রিয়া-চক্র ও শেখার কৌশল। এটি কোডবেসের জ্ঞান ছড়ায়, আগেভাগে ত্রুটি ধরে, এবং দলের কর্মচুক্তি ও সমাপ্তির সংজ্ঞা প্রয়োগ করে। ITIL দৃষ্টিতে একই কর্মকাণ্ড বেশ কয়েকটি চর্চাকে সমর্থন করে। ITIL 4-এ সফটওয়্যার উন্নয়ন ও ব্যবস্থাপনা চর্চা ঢাকে সফটওয়্যার কীভাবে তৈরি ও যাচাই হয়, পরিবর্তন সক্ষমকরণ ঢাকে পরিবর্তন কীভাবে মূল্যায়িত ও অনুমোদিত হয়, এবং ডিপ্লয়মেন্ট ব্যবস্থাপনা ঢাকে পরিবর্তন কীভাবে চালু পরিবেশে পৌঁছায়। অনেক সংগঠনের জন্য সহকর্মী-পর্যালোচিত একটি পুল রিকোয়েস্ট একটি আদর্শ পরিবর্তন রিলিজের আগে মূল্যায়িত হয়েছিল তার প্রমাণ। রিভিউকে মাপা, উন্নত করা যায় এমন কর্মকাণ্ড হিসেবে দেখা দুই দৃষ্টিভঙ্গিকেই সেবা করে: এজাইল দল দ্রুততর প্রতিক্রিয়া চায়, আর ITIL চর্চা চায় পরিবর্তন যাচাই করা হয়েছে তার নির্ভরযোগ্য নিশ্চয়তা।
সমস্ত সময়ে মনে রাখার ঝুঁকি হলো রিভিউয়ের গতি ও রিভিউয়ের গুণমান আলাদা করা সহজ। একটি দল দেখামাত্র সবকিছু অনুমোদন করে প্রথম রিভিউয়ের সময় অর্ধেক করতে পারে, আর ড্যাশবোর্ড বিজয় দেখাবে যখন কোডবেস খারাপ হচ্ছে। গুডহার্টের সূত্র (Goodhart's law) এই মেট্রিক পরিবারে অস্বাভাবিক জোরের সঙ্গে প্রযোজ্য (বিষয় 1.2, গুডহার্টের সূত্র ও মেট্রিকের মনস্তত্ত্ব দেখুন), কারণ সংখ্যাগুলো সংগ্রহ করা সস্তা, সবার কাছে দৃশ্যমান, এবং যা তারা প্রতিনিধিত্ব করার কথা তা না বদলে নড়ানো তুচ্ছ রকম সহজ। নিচের প্রতিটি সুপারিশ এটি মনে রেখে লেখা।
লেখক (author) পুল রিকোয়েস্ট খুলেছেন আর একজন পর্যালোচক (reviewer) তা মূল্যায়ন করেন। একটি রিভিউ রাউন্ড (review round) হলো "লেখক পুশ করেন, পর্যালোচক সাড়া দেন"-র একটি চক্র। পুনঃকাজ (rework) হলো রিভিউয়ের মন্তব্যের পরে, বা মার্জের পরে, প্রথম সংস্করণ যা ভুল করেছিল তা সারাতে করা পরিবর্তন। কন্টিনিউয়াস ইন্টিগ্রেশন (CI) হলো একটি ভাগ করা ধারায় ঘন ঘন কাজ মার্জ করা এবং প্রতিটি মার্জ স্বয়ংক্রিয়ভাবে যাচাই করার চর্চা; কন্টিনিউয়াস ইন্টিগ্রেশন (continuous integration) দেখুন।
এই বিষয়ের সব মেট্রিক দল ও রিপোজিটরি বর্ণনা করে। এগুলো কখনও পর্যালোচক বা লেখককে ক্রম দেয় না। ব্যক্তি-স্তরের রিভিউয়ের গণনা বের করা সহজ এবং ব্যবহারের প্রলোভন আছে, আর তা করলে সহযোগিতার চর্চা প্রতিযোগিতায় পরিণত হয় (বিষয় 9.1, দলের সুস্থতা ও ডেভেলপার অভিজ্ঞতা দেখুন)।
মূল নীতি
- অপেক্ষাই রিভিউকে ছাপিয়ে যায়। বেশিরভাগ দলে রিভিউ সময়ের সবচেয়ে বড় অংশ পুল রিকোয়েস্টের অপঠিত পড়ে থাকা, পর্যালোচক শুরু করার পর আলোচনা নয়। আলোচনা মাপার আগে অপেক্ষা মাপুন।
- ছোট পরিবর্তন দ্রুততর ও ভালোভাবে পর্যালোচিত হয়। আকার সেই অল্প কয়েকটি উপায়ের একটি যা গতি ও পুঙ্খানুপুঙ্খতা দুটোই একসঙ্গে উন্নত করে, কারণ পর্যালোচক একটি ছোট পরিবর্তন মাথায় ধরে রাখতে পারেন।
- যাচাই ছাড়া গতি উন্নতি নয়। এই বিষয়ের প্রতিটি গতির মেট্রিকের একটি গুণমানের সমতুল্য দরকার, এবং জোড়টি একসঙ্গে পড়া হয়।
- রিভিউ একটি দলের ধারণক্ষমতা, ব্যক্তিগত নয়। ভার দলজুড়ে ছড়ানো উচিত। যে মেট্রিক কেন্দ্রীভবন দেখায় সে দলের নকশার সমস্যার দিকে ইঙ্গিত করে, কোনো ব্যক্তিকে প্রশংসা বা দোষারোপের জন্য নয়।
- গড়ের চেয়ে বিন্যাস ভালো। রিভিউয়ের সময়ে আটকে থাকা পুল রিকোয়েস্টের লম্বা লেজ আছে, তাই মধ্যমান ও একটি উচ্চ পার্সেন্টাইল প্রতিবেদন করুন (বিষয় 1.6, সেবা মেট্রিকের জন্য পরিসংখ্যান-সাক্ষরতা দেখুন)।
- ঘড়ি সংজ্ঞায়িত করুন, তারপর তাকে একা রাখুন। ঘড়ি কখন শুরু ও থামে, কোন ইভেন্ট তাকে বিরতি দেয় এবং কোন স্বয়ংক্রিয় কার্যকলাপ বাদ তা বলুন, এবং তথ্য যেখানে থাকে সেখানে লিখে রাখুন (বিষয় 1.5, তথ্যের উৎস ও ইনস্ট্রুমেন্টেশন দেখুন)।
- রিভিউ মেট্রিক সেই দলকে সেবা করে যে কাজের মালিক। এগুলো দলের নিজস্ব রেট্রোস্পেকটিভের ইনপুট, অন্য কারও জন্য স্কোরকার্ড নয়।
মেট্রিকের সংজ্ঞা
নিচের ঘড়িগুলো ধরে নেয় ভার্সন কন্ট্রোল প্ল্যাটফর্ম খোলা, রিভিউয়ের অনুরোধ, মন্তব্য, অনুমোদন, পুশ ও মার্জের ইভেন্টের সময় লিপিবদ্ধ করে। কোনো সারি অন্যথা না বললে ড্রাফট, বট খোলা পুল রিকোয়েস্ট এবং মার্জ ছাড়া বন্ধ পুল রিকোয়েস্ট বাদ। "কাজের ঘণ্টা" মানে দলের ঘোষিত কাজের ঘণ্টা, যাতে শুক্রবার সন্ধ্যায় খোলা পুল রিকোয়েস্ট সপ্তাহান্তের অপেক্ষা জমা না করে।
| মেট্রিক | সংজ্ঞা | সূত্র | একক | তথ্যের উৎস | ITIL চর্চা | এজাইল সমতুল্য | পর্যায়কাল |
|---|---|---|---|---|---|---|---|
| প্রথম রিভিউয়ের সময় | একটি পুল রিকোয়েস্ট রিভিউয়ের জন্য প্রস্তুত হওয়া এবং প্রথম গুরুত্বপূর্ণ মানবিক সাড়ার মধ্যবর্তী অপেক্ষা | ঘড়ি শুরু হয় পুল রিকোয়েস্ট ড্রাফট ছাড়লে বা প্রস্তুত অবস্থায় খোলা হলে, থামে লেখক ছাড়া অন্য কারও প্রথম রিভিউ মন্তব্য, পরিবর্তনের অনুরোধ বা অনুমোদনে; বট ও লেখকের মন্তব্য এবং নিছক লেবেল পরিবর্তন বাদ। মধ্যমান ও ৮৫তম পার্সেন্টাইল কাজের ঘণ্টায় প্রতিবেদন করুন | কাজের ঘণ্টা | ভার্সন কন্ট্রোল প্ল্যাটফর্মের ইভেন্টের ইতিহাস | সফটওয়্যার উন্নয়ন ও ব্যবস্থাপনা; পরিবর্তন সক্ষমকরণ | রিভিউয়ের সাড়াশীলতা নিয়ে কর্মচুক্তি; চলমান কাজের প্রবাহ | সাপ্তাহিক |
| রিভিউ সাইকল টাইম | রিভিউয়ের জন্য প্রস্তুত থেকে মার্জ পর্যন্ত মোট সময় | ঘড়ি শুরু হয় পুল রিকোয়েস্ট রিভিউয়ের জন্য প্রস্তুত হলে, থামে মার্জে; মার্জ ছাড়া বন্ধ পুল রিকোয়েস্ট বাদ এবং আলাদাভাবে গোনা। মধ্যমান ও ৮৫তম পার্সেন্টাইল কাজের ঘণ্টায় প্রতিবেদন করুন | কাজের ঘণ্টা | ভার্সন কন্ট্রোল প্ল্যাটফর্মের ইভেন্টের ইতিহাস | ডিপ্লয়মেন্ট ব্যবস্থাপনা; পরিবর্তন সক্ষমকরণ | দলের বোর্ডে রিভিউ ধাপের সাইকল টাইম | সাপ্তাহিক |
| পুল রিকোয়েস্টের আকার | একটি পুল রিকোয়েস্টে পরিবর্তনের পরিমাণ | যুক্ত লাইন যোগ মুছে ফেলা লাইন, রিপোজিটরির ignore নিয়মে তালিকাভুক্ত জেনারেটেড ফাইল, লক ফাইল, ভেন্ডর কোড ও নিছক নাম পরিবর্তন বাদ দিয়ে। প্রতিটি মার্জ করা পুল রিকোয়েস্টের মধ্যমান ও ৮৫তম পার্সেন্টাইল প্রতিবেদন করুন | পরিবর্তিত লাইন | ভার্সন কন্ট্রোল প্ল্যাটফর্মের ডিফ পরিসংখ্যান | সফটওয়্যার উন্নয়ন ও ব্যবস্থাপনা | ছোট ব্যাচের আকার; স্টোরি ভাঙা | সাপ্তাহিক |
| রিভিউ রাউন্ড | মার্জের আগে লেখকের পুশ ও পর্যালোচকের সাড়ার চক্রের সংখ্যা | প্রতিটি মার্জ করা পুল রিকোয়েস্টে স্বতন্ত্র "পরিবর্তন চাওয়া হয়েছে" বা মন্তব্য-তারপর-পুশ চক্রের গণনা; প্রথম জমা রাউন্ড শূন্য এবং স্বয়ংক্রিয় যাচাইয়ের ব্যর্থতা বাদ। মধ্যমান ও ৮৫তম পার্সেন্টাইল প্রতিবেদন করুন | গণনা | ভার্সন কন্ট্রোল প্ল্যাটফর্মের রিভিউ ও পুশ ইভেন্ট | নিরন্তর উন্নয়ন; সফটওয়্যার উন্নয়ন ও ব্যবস্থাপনা | রিভিউ ধাপে পুনঃকাজের সংকেত; সমাপ্তির সংজ্ঞা | সাপ্তাহিক |
| রিভিউ ভারের কেন্দ্রীভবন | একটি দলে রিভিউয়ের কাজ কত অসমভাবে ছড়ানো | ঘূর্ণায়মান ৪ সপ্তাহে দলের সম্পন্ন রিভিউয়ের যে অংশ দুজন সবচেয়ে ব্যস্ত পর্যালোচক সামলেছেন; নিজের পুল রিকোয়েস্টের রিভিউ ও বট রিভিউ বাদ। দলের জন্য প্রতিবেদিত, নামসহ কখনও নয় | শতাংশ | দলে সমষ্টি করা ভার্সন কন্ট্রোল প্ল্যাটফর্মের রিভিউ ইভেন্ট | নিরন্তর উন্নয়ন; জ্ঞান ব্যবস্থাপনা | ভাগ করা কোডের মালিকানা; যৌথ মালিকানা | মাসিক |
| বাসি পুল রিকোয়েস্টের গণনা | দলের সম্মত সীমার চেয়ে বেশি সময় খোলা থাকা পুল রিকোয়েস্ট | এখনও খোলা এবং ড্রাফট নয় এমন পুল রিকোয়েস্ট যার রিভিউয়ের জন্য প্রস্তুত থেকে বয়স দলের সীমা ছাড়িয়েছে, স্ন্যাপশটের সময়ে গোনা; ড্রাফট বাদ | গণনা | ভার্সন কন্ট্রোল প্ল্যাটফর্মের খোলা পুল রিকোয়েস্টের তালিকা | পরিবর্তন সক্ষমকরণ; নিরন্তর উন্নয়ন | কাজের আইটেমের বয়স; WIP সীমা | সাপ্তাহিক |
| মার্জ-পরবর্তী সংশোধনের হার | মার্জ করা পুল রিকোয়েস্টের যে অংশের অল্প পরে একটি সংশোধনী পরিবর্তন এসেছে | ১৪ দিনের মধ্যে একই পরিবর্তনের সঙ্গে যুক্ত সংশোধন, রিভার্ট বা হটফিক্সসহ মার্জ করা পুল রিকোয়েস্ট / সময়কালে মার্জ করা পুল রিকোয়েস্ট; পরিকল্পিত ফলোআপ কাজ হিসেবে লেবেল করা বাদ | শতাংশ | ভার্সন কন্ট্রোল ইতিহাস, যুক্ত ইস্যু এবং ইনসিডেন্ট বা পরিবর্তনের রেকর্ড | পরিবর্তন সক্ষমকরণ; ইনসিডেন্ট ব্যবস্থাপনা | গুণমান ভেতরে গাঁথা; সমাপ্তির সংজ্ঞা | মাসিক |
প্রথম রিভিউয়ের সময় সবচেয়ে বড় উপায় এবং বেশিরভাগ দলের যে মেট্রিক দিয়ে শুরু করা উচিত। রিভিউ সাইকল টাইম তার ফলের পরিমাপ এবং বিষয় 2.2-এ আলোচিত দীর্ঘতর লিড টাইমের একটি উপাদান। ১৪ দিনের জানালা ও বাসি সীমা উদাহরণ; প্রতিটি দল তার রিলিজের ছন্দের সঙ্গে মেলে এমন মান বেছে লিখে রাখে। যেখানে সংখ্যাগুলো ব্যাপক ডেলিভারির ছবিতে যায়, সেখানে DORA পরিবার (বিষয় 2.8, DORA মেট্রিক দেখুন) এবং পরিবর্তন ব্যর্থতার পরিমাপ (বিষয় 4.4, পরিবর্তনের ব্যর্থতা ও পুনঃকাজ দেখুন) দায়িত্ব নেয়।
সুপারিশ
কাজের আগে অপেক্ষা মাপুন
1. প্রথম রিভিউয়ের সময় দিয়ে শুরু করুন। এটি সাধারণত রিভিউ সময়ের সবচেয়ে বড় অবদানকারী এবং উন্নত করা সবচেয়ে সস্তা। কাউকে কিছু লিখতে না হয় এজন্য প্ল্যাটফর্মের ইভেন্টের ইতিহাস থেকে এটি ইনস্ট্রুমেন্ট করুন। মধ্যমান ও একটি উচ্চ পার্সেন্টাইল প্রতিবেদন করুন, কারণ তিন ঘণ্টার মধ্যমান ও চার দিনের ৯৫তম পার্সেন্টাইল মানে কিছু পরিবর্তন ভুলে যাওয়া হচ্ছে।
2. ঘড়ি থেকে বট ও ড্রাফট বাদ দিন, এবং তা বলুন। স্বয়ংক্রিয় যাচাই, নির্ভরতা হালনাগাদের বট এবং ফরম্যাটিং টুল সেকেন্ডে মন্তব্য তৈরি করে, আর সেগুলো গুনলে অপেক্ষা চমৎকার দেখায়। ঘড়ি শুরু করুন লেখক পরিবর্তন প্রস্তুত চিহ্নিত করলে, শাখা প্রথম পুশ করলে নয়। নিয়মগুলো চার্টের পাশে প্রকাশ করুন।
3. কাজের ঘণ্টা ব্যবহার করুন এবং দলের ক্যালেন্ডার লিখে রাখুন। শুক্রবার দেরিতে খোলা একটি পুল রিকোয়েস্টের সপ্তাহান্তের অপেক্ষা বহন করা উচিত নয়। সময় অঞ্চলে ছড়ানো একটি দলের নিয়ম লাগে কার ঘণ্টা গোনা হবে, আর সৎ উত্তর প্রায়ই অঞ্চল জুড়ে হস্তান্তরের খরচই দেখার মতো। বাছাই বলুন এবং স্থির রাখুন।
কাজকে পর্যালোচনাযোগ্য করে সাজান
4. পুল রিকোয়েস্ট ছোট রাখুন, এবং আকারকে দলের অভ্যাস হিসেবে দেখুন। আকারের মধ্যমান ও ৮৫তম পার্সেন্টাইল ট্র্যাক করুন, এবং বড়গুলোকে স্বতন্ত্র ব্যর্থতা নয়, একটি সংগ্রহ হিসেবে দেখুন। দলগুলো সাধারণত দেখে বড় পরিবর্তন কয়েকটি কারণ থেকে আসে: কাজ যথেষ্ট সূক্ষ্মভাবে না কাটা, রিফ্যাক্টরিং ও নতুন আচরণ মেশানো, বা মার্জ করতে বেশি দেরি করা। কাজ এমনভাবে কাটুন যাতে প্রতিটি পুল রিকোয়েস্ট একটি জিনিস করে, যা ট্রাঙ্ক-ভিত্তিক উন্নয়ন (trunk-based development) ও ঘন ঘন ডিপ্লয়মেন্টের পেছনের ছোট ব্যাচের নীতির সঙ্গেও মেলে।
5. কঠোর আকারের সীমাকে লক্ষ্য হিসেবে ঠিক করবেন না। "৪০০ লাইনের বেশি নয়"-এর মতো সীমা একটি পরিবর্তনকে কৃত্রিম টুকরোয় ভাঙতে আমন্ত্রণ জানায়, যা আলাদাভাবে পড়ার অযোগ্য বা একা মার্জ হলে বিল্ড ভাঙে। আকারকে রেট্রোস্পেকটিভে আলাপের সূচনা হিসেবে ব্যবহার করুন, এবং দলকে কাটার কৌশল দিন, যেমন ফিচার টগল, নিজস্ব পুল রিকোয়েস্টে প্রস্তুতিমূলক রিফ্যাক্টরিং, এবং পতাকার পেছনে মার্জ।
6. রিভিউয়ের অনুরোধ সুস্পষ্ট করুন। কোনো পর্যালোচকের নাম না থাকা পুল রিকোয়েস্ট স্বেচ্ছাসেবকের জন্য অপেক্ষা করে, আর স্বেচ্ছাসেবক দুর্লভ। কর্মচুক্তিতে একমত হোন কাকে জিজ্ঞাসা করা হবে, দলকে কীভাবে জানানো হবে এবং সাড়ার প্রত্যাশা কী। একটি ভাগ করা রিভিউ রোটা, বা দৈনিক রিভিউ স্লট, সাধারণত যেকোনো টুল সেটিংয়ের চেয়ে বেশি অপেক্ষা কমায়।
ভার ও জ্ঞান ছড়ান
7. দল-স্তরের ঝুঁকি হিসেবে ভারের কেন্দ্রীভবন দেখুন। দুজন মানুষ বেশিরভাগ রিভিউ সামলালে তাঁদের প্রাপ্যতা দলের প্রবাহ সীমিত করে, আর তাঁদের অনুপস্থিতি তা থামায়। কেন্দ্রীভবনের পরিমাপ মাসিক পর্যালোচনা করুন এবং দলের নকশার মাধ্যমে পদক্ষেপ নিন: ডিফল্ট পর্যালোচক ঘোরান, নতুন সদস্যদের অভিজ্ঞদের সঙ্গে জোড় বাঁধুন, এবং কোডের যে অংশ কেবল একজন মানুষ পর্যালোচনা করতে পারেন তা লিখে রাখুন। প্রতি-ব্যক্তি লিডারবোর্ড প্রকাশ করবেন না।
8. জ্ঞান ভাগ করতে রিভিউ ব্যবহার করুন, এবং সেই উদ্দেশ্য রক্ষা করুন। রিভিউয়ের দীর্ঘমেয়াদি মূল্যের মধ্যে ত্রুটি শনাক্তকরণের পাশাপাশি শেখা, ভাগ করা মালিকানা এবং সঙ্গতিপূর্ণ শৈলী আছে। পেয়ার প্রোগ্রামিং (pair programming) ও মব প্রোগ্রামিং সেই আদান-প্রদানের কিছু প্রক্রিয়ায় আগে সরিয়ে আনে; যেখানে একটি জোড় ইতিমধ্যে একটি পরিবর্তনে কাজ করেছে, সেখানে হালকা রিভিউ যুক্তিসংগত। বাছাইটিকে দলের সিদ্ধান্ত করুন, কর্মচুক্তিতে লেখা, যাতে "জোড়ে করা হয়েছে, তাই হালকা পর্যালোচনা" একটি দৃশ্যমান নিয়ম হয়, অজুহাত নয়।
রিভিউ নিজেই নিয়ন্ত্রণ করুন
9. অটোমেশন যা ভালো করে তা অটোমেশনকে করতে দিন। ফরম্যাটিং, লিন্টিং ও মৌলিক যাচাই পাইপলাইনের, যাতে মানুষের মনোযোগ নকশা, সঠিকতা ও ঝুঁকিতে যায়। স্ট্যাটিক প্রোগ্রাম বিশ্লেষণ (static program analysis) ও স্বয়ংক্রিয় পরীক্ষা তুচ্ছ রিভিউ রাউন্ডের সংখ্যা কমায়। তখন বাকি রাউন্ডগুলো শৈলীর মতভেদ নিয়ে কম, নকশার আলাপ নিয়ে বেশি বলে।
10. রিভিউ রাউন্ডকে ত্রুটির গণনা নয়, স্পষ্টতার সংকেত হিসেবে পড়ুন। অনেক রাউন্ড মানে প্রয়োজনীয়তা অস্পষ্ট ছিল, লেখকের প্রসঙ্গের অভাব ছিল, পর্যালোচক রুচির পরিবর্তন চেয়েছিলেন, বা পরিবর্তন বড় ছিল। প্রতিটি পুল রিকোয়েস্টে শূন্য রাউন্ড চমৎকার কাজ বা কেউ দেখেনি বোঝাতে পারে। অস্বাভাবিক বেশি বা অস্বাভাবিক কম রাউন্ডের কয়েকটি পুল রিকোয়েস্টের নমুনা নিন এবং দল হিসেবে একসঙ্গে পড়ুন।
গতিকে গুণমানের সঙ্গে জোড় বাঁধুন, এবং সময় দৃশ্যমান রাখুন
11. রিভিউয়ের গতির পাশে সবসময় একটি গুণমানের সমতুল্য দেখান। মার্জ-পরবর্তী সংশোধনের হার, সাম্প্রতিক পরিবর্তনের সঙ্গে যুক্ত ইনসিডেন্ট এবং রিলিজের পর পাওয়া ত্রুটির অংশ স্বাভাবিক সঙ্গী (বিষয় 4.4, পরিবর্তনের ব্যর্থতা ও পুনঃকাজ দেখুন)। রিভিউয়ের সময় উন্নত হলে সংশোধনের হার খারাপ হলে দল নিশ্চয়তাকে গতির বিনিময়ে দিয়েছে, এবং সমাধান একটি লক্ষ্য নয়, একটি আলাপ। দুটোই একই চার্টে দেখান।
12. রিভিউকে প্রবাহের ছবি এবং অপরিকল্পিত কাজের সঙ্গে যুক্ত করুন। দ্রুততর রিভিউ কেবল তখনই সাহায্য করে, যখন পরবর্তী ধাপ কাজটিকে শুধু সারিতে ফেলে না (বিষয় 2.3, চলমান কাজ (WIP) ও সারিতত্ত্ব দেখুন)। পরিকল্পিত কাজে বাধা দেওয়া জরুরি রিভিউ অনুরোধের নিজস্ব খরচ আছে (বিষয় 2.9, পরিচালনামূলক কাজ ও অপরিকল্পিত কাজ দেখুন)।
কারসাজির উপায় ও রক্ষাবেষ্টনী
| মেট্রিক | যেভাবে কারসাজি হয় | জোড়া রক্ষাবেষ্টনী মেট্রিক বা চর্চা |
|---|---|---|
| প্রথম রিভিউয়ের সময় | প্রথম সাড়া হিসেবে একটি দ্রুত "ভালো দেখাচ্ছে" বা ইমোজি পোস্ট করা; একটি বট বা বন্ধুভাবাপন্ন পর্যালোচক বরাদ্দ করা; কেউ আগে থেকে দেখতে রাজি হওয়ার পরেই কেবল পুল রিকোয়েস্ট প্রস্তুত চিহ্নিত করা | মার্জ-পরবর্তী সংশোধনের হার; মন্তব্যহীন অনুমোদনের নমুনা; কর্মচুক্তিতে প্রথম সাড়া গুরুত্বপূর্ণ হওয়ার দাবি |
| রিভিউ সাইকল টাইম | রিভিউয়ের অপেক্ষা না করে মার্জ করা; দ্রুত পাস করতে পরিবর্তনকে ক্ষুদ্র টুকরোয় ভাঙা; ঘড়ি রিসেট করতে পুল রিকোয়েস্ট বন্ধ করে আবার খোলা | বন্ধ-করে-আবার-খোলা পুল রিকোয়েস্ট গুনুন; রিভিউ রাউন্ড; মার্জ-পরবর্তী সংশোধনের হার; অনুমোদন দাবি করা সুরক্ষিত শাখার নিয়ম |
| পুল রিকোয়েস্টের আকার | গণনা থেকে ফাইল বাদ দেওয়া; একটি পরিবর্তনকে আলাদাভাবে বোঝা যায় না এমন টুকরোয় ভাঙা; জেনারেটেড কোড দিয়ে আকার ফোলানো | প্রতি ত্রৈমাসিকে ignore নিয়ম পর্যালোচনা করুন; ভাঙা টুকরো একা বিল্ড হয় ও পরীক্ষা পাস করে কি না যাচাই করুন; সবচেয়ে ছোট ও সবচেয়ে বড়র একটি নমুনা পড়ুন |
| রিভিউ রাউন্ড | গণনা কম রাখতে প্রথম পাসেই অনুমোদন; আলোচনা চ্যাটে সরানো যাতে কোনো চিহ্ন না থাকে; রাউন্ড লুকাতে লেখকের এক কমিটে অনেক ফিক্স-আপ পুশ | মার্জ-পরবর্তী সংশোধনের হার; শূন্য-রাউন্ড পুল রিকোয়েস্টের নমুনা; আলোচনা পুল রিকোয়েস্টে রাখুন |
| রিভিউ ভারের কেন্দ্রীভবন | গণনা ছড়াতে রিভিউকে অনেক ছোট অনুমোদনে ভাঙা; জ্ঞান নেই অথচ সময় আছে এমন মানুষদের রিভিউ বরাদ্দ | ঝুঁকিপূর্ণ অংশের জন্য পর্যালোচকের জ্ঞান পর্যালোচনা করুন; অংশ অনুযায়ী মার্জ-পরবর্তী সংশোধনের হার দেখুন; মেট্রিক দল-স্তরে রাখুন |
| বাসি পুল রিকোয়েস্টের গণনা | মার্জ ছাড়া বাসি পুল রিকোয়েস্ট বন্ধ করা; লুকাতে ড্রাফটে রূপান্তর; বাসি সীমা বাড়ানো | অমার্জিত বন্ধ পুল রিকোয়েস্টের গণনা; দীর্ঘস্থায়ী ড্রাফটের গণনা; প্রতি ত্রৈমাসিকে দলের সঙ্গে সীমা পর্যালোচনা |
| মার্জ-পরবর্তী সংশোধনের হার | সংযোগ ছাড়া নতুন কাজের আইটেমে সংশোধন লিপিবদ্ধ করা; সংশোধনী কাজকে পরিকল্পিত ফলোআপ লেবেল করা; জানালা পেরিয়ে সংশোধন পিছিয়ে মেট্রিক এড়ানো | ইনসিডেন্ট ও পরিবর্তন ব্যর্থতার তথ্যের সঙ্গে তুলনা; ফলোআপ আইটেমের নমুনা; ব্যবহৃত লেবেলের নিরীক্ষা |
সুস্থ পাঠ শান্ত। প্রথম রিভিউয়ের সময় ছোট এবং লেজও ছোট, তাই কোনো পুল রিকোয়েস্ট দিনের পর দিন অপেক্ষা করে না। আকার দল সহজে পড়তে পারে এমন পরিসরে থাকে, কয়েকটি বড় পরিবর্তন সহ যা দল ব্যাখ্যা করতে পারে। রিভিউ রাউন্ড কম কিন্তু শূন্য নয়, ভারের কেন্দ্রীভবন মাঝারি, বাসির গণনা অল্প, এবং মার্জ-পরবর্তী সংশোধনের হার স্থিতিশীল। একটি সংখ্যা তীব্রভাবে উন্নত হলে কারও যাচাই করা উচিত তার জোড়া রক্ষাবেষ্টনী ভুল দিকে নড়েনি।
ভারসাম্য: সুবিধা ও অসুবিধা
| পদ্ধতি | শক্তি | দুর্বলতা |
|---|---|---|
| কঠোর সাড়ার প্রত্যাশাসহ দ্রুত রিভিউ | ছোট প্রতিক্রিয়া-চক্র; লেখকের কম প্রসঙ্গ-হারানো; কম চলমান কাজ | দ্রুত অনুমোদনের চাপ; একাগ্র কাজে বাধা |
| ধীর, পুঙ্খানুপুঙ্খ রিভিউ | নকশা ও ঝুঁকির সতর্ক পাঠ; শক্তিশালী জ্ঞান হস্তান্তর | লম্বা সাইকল টাইম; বড় ব্যাচ জমে; লেখক এগিয়ে যান ও প্রসঙ্গ হারান |
| ছোট পুল রিকোয়েস্ট | পড়া ও রিভার্ট করা সহজ; মসৃণ প্রবাহ | প্রতি পরিবর্তনে বেশি বাড়তি কাজ; একটি ফিচারকে বিভ্রান্তিকর ধাপে টুকরো করতে পারে |
| বড় পুল রিকোয়েস্ট | কম হস্তান্তর; পুরো ফিচার একসঙ্গে দৃশ্যমান | রিভিউ অগভীর হয়; রিভার্ট করা কঠিন; লম্বা অপেক্ষা |
| নামযুক্ত মালিকের কাছ থেকে অনুমোদন দাবি | ঝুঁকিপূর্ণ অংশের জন্য পরিষ্কার জবাবদিহি; পরিবর্তনের অনুমোদনকে সমর্থন করে | বাধা ও একক ব্যর্থতার বিন্দু তৈরি করে |
| মানবিক রিভিউয়ের আগে স্বয়ংক্রিয় যাচাই | নকশা ও ঝুঁকির জন্য মানুষকে মুক্ত করে; সঙ্গতিপূর্ণ | মিথ্যা আত্মবিশ্বাস তৈরি করতে পারে; রক্ষণাবেক্ষণ লাগে |
কোনো একক নীতি জেতে না। উদ্দেশ্য যাচাই বজায় রেখে অপেক্ষা ছোট করা, আর সাধারণ পথ হলো ছোট পরিবর্তন, পরিষ্কার রিভিউয়ের প্রত্যাশা, নিয়মিত যাচাইয়ের জন্য শক্তিশালী অটোমেশন, এবং একটি ভালো রিভিউ কেমন তা নিয়ে দলের চুক্তি। রিভিউ মেট্রিক রেট্রোস্পেকটিভের প্রশ্ন হিসেবে সবচেয়ে কাজের এবং লক্ষ্য হিসেবে সবচেয়ে কম কাজের।
দলের সঙ্গে আলোচনার প্রশ্ন
1. একটি পুল রিকোয়েস্ট তার জীবনের বেশিরভাগ কোথায় কাটায়, অপেক্ষায় না রিভিউতে? তথ্য দেখার আগে দলকে অনুমান করতে বলুন, তারপর প্রথম রিভিউয়ের সময় ও মার্জ পর্যন্ত বাকি সময়ের বিভাজন দেখান। কতটা অপেক্ষা তা দেখে বেশিরভাগ গোষ্ঠী অবাক হয়। সঞ্চালক লিখে রাখুন কোন অনুমান ভুল ছিল এবং জিজ্ঞাসা করুন প্রতিটি ভুল অনুমান দল রিভিউ কীভাবে অনুভব করে সে সম্পর্কে কী বলে। সবচেয়ে বড় অপেক্ষাকে আক্রমণ করে এমন একটি পরিবর্তন দিয়ে শেষ করুন।
2. এই দলে একটি ভালো রিভিউ কেমন দেখায়, এবং বাইরের কেউ কীভাবে বলতে পারতেন? দল মূল্য দেয় এমন আচরণ তালিকা করুন, যেমন নকশা সম্পর্কে জিজ্ঞাসা, পরীক্ষা যাচাই এবং অনুরোধের কারণ ব্যাখ্যা। তারপর জিজ্ঞাসা করুন এর কোনগুলো পুল রিকোয়েস্টে দৃশ্যমান চিহ্ন রাখে। ব্যক্তিকে পাহারা না দিয়ে একটি গুরুত্বপূর্ণ প্রথম সাড়া আর প্রতীকী সাড়ার পার্থক্য কীভাবে বলবেন আলোচনা করুন। কর্মচুক্তিতে রাখার জন্য একটি সংক্ষিপ্ত লিখিত বর্ণনায় একমত হোন।
3. আমাদের জন্য কতটা বড় অতিরিক্ত বড়, এবং কাজ সত্যিই বড় হলে আমরা কী করি? আকারের বিন্যাস দেখুন এবং সবচেয়ে বড় কয়েকটি পুল রিকোয়েস্ট বাছুন। জিজ্ঞাসা করুন প্রতিটি কেন বড় ছিল এবং ভাঙা যেত কি না। ফিচার টগল, প্রস্তুতিমূলক রিফ্যাক্টরিং এবং পতাকার পেছনে মার্জের মতো কৌশল আলোচনা করুন। সঞ্চালক সংখ্যাগত সীমা ঠিক করা প্রতিরোধ করুন, এবং বদলে এক মাস দল চেষ্টা করবে এমন একটি অভ্যাসে একমত হোন।
4. আমাদের সবচেয়ে ঝুঁকিপূর্ণ কোড কে পর্যালোচনা করেন, এবং তিনি অনুপস্থিত থাকলে কী হয়? কোডের অংশগুলোকে যাঁরা সেগুলো ভালোভাবে পর্যালোচনা করতে পারেন তাঁদের সঙ্গে ম্যাপ করুন। ভারের কেন্দ্রীভবন এবং একক যোগ্য পর্যালোচকের অংশগুলো দেখুন। জোড়ে কাজ বা বরাদ্দ ঘুরিয়ে প্রতিটিতে দ্বিতীয় পর্যালোচক কীভাবে গড়বেন আলোচনা করুন। আলাপ দলের স্থিতিস্থাপকতা নিয়ে রাখুন, কারও কাজের ভারের ক্রম নিয়ে নয়।
5. আমাদের রিভিউয়ের গতি কাল দ্বিগুণ হলে গুণমান সম্পর্কে আমরা কী সত্য চাইতাম? গোষ্ঠীকে বলুন তাঁরা কোন গুণমানের সংকেত দেখবেন, যেমন মার্জ-পরবর্তী সংশোধন, সাম্প্রতিক পরিবর্তনের সঙ্গে যুক্ত ইনসিডেন্ট বা রিভার্টের সংখ্যা। যাচাই করুন সেই সংকেতগুলো বর্তমানে গতির চার্টের পাশে দৃশ্যমান কি না। আলোচনা করুন গতি পুঙ্খানুপুঙ্খতার মূল্যে কেনা হয়েছে তার আগাম লক্ষণ কী হত। ড্যাশবোর্ডে কোন সমতুল্য দেখাবেন তাতে একমত হোন।
6. কোন রিভিউ সংখ্যা আমরা এমনভাবে উন্নত করতে প্রলুব্ধ হতাম যা সাহায্য করে না? প্রতিটি মেট্রিক ধরে জিজ্ঞাসা করুন চাপে থাকা কেউ কিছু ভালো না করে তাকে কীভাবে ভালো দেখাতে পারেন। উত্তরগুলো ওপরের কারসাজির সারণির সঙ্গে তুলনা করুন এবং দলের নিজের ধারণা যোগ করুন। উদ্দেশ্য ঘটার আগে ঝুঁকির নাম দেওয়া। প্রতিটি মেট্রিকের পাশে কোন রক্ষাবেষ্টনী পর্যালোচিত হবে তাতে একমত হোন।
চারটি দৃষ্টিভঙ্গি
পণ্য ও ডেলিভারি দল
ডেলিভারি দল রিভিউ প্রক্রিয়ার মালিক এবং তার মেট্রিকেরও মালিক হওয়া উচিত। সরল চুক্তি দিয়ে অপেক্ষা ছোট করে তারা সবচেয়ে বেশি লাভ করে: একটি দৈনিক রিভিউ স্লট, একটি পরিষ্কার অনুরোধ প্রক্রিয়া এবং ছোট পরিবর্তন। রেট্রোস্পেকটিভে সংখ্যা ব্যবহার করা, চলমান কাজ কম রাখা এবং একটিমাত্র চার্ট অপ্টিমাইজ করার প্রলোভন প্রতিরোধ করা তাদের উচিত। রিভিউ সেই জায়গাও যেখানে নতুন সদস্যরা কোডবেস শেখেন, তাই সেই উদ্দেশ্য রক্ষা করুন।
সেবা ও পরিচালন দল
পরিচালন দল রিভিউয়ের মুখোমুখি হয় যেখানে অবকাঠামোর কোড, কনফিগারেশন ও রানবুক অটোমেশন পুল রিকোয়েস্টের মাধ্যমে বদলানো হয়। তাদের কাছে রিভিউ প্রায়ই একটি আদর্শ পরিবর্তন অনুমোদন ও প্রমাণ করার অংশ (বিষয় 4.3, পরিবর্তন সক্ষমকরণের মেট্রিক দেখুন)। কোন পরিবর্তনে দ্বিতীয় ব্যক্তির রিভিউ লাগে, জরুরি সংশোধন কত দ্রুত পর্যালোচিত হয়, এবং জরুরি পরিবর্তন পরে কীভাবে পর্যালোচিত হয় তাতে তারা একমত হবে, যাতে তাড়াহুড়োর সংশোধনও পরীক্ষিত হয়। ঝুঁকিপূর্ণ পরিবর্তনে পাতলা রিভিউ পরে ইনসিডেন্ট হয়ে দেখা দেয়।
নেতৃত্ব ও গভর্ন্যান্স
নেতাদের রিভিউ মেট্রিককে দলের সুস্থতা ও প্রবাহের সংকেত হিসেবে দেখা উচিত, উৎপাদনশীলতার স্কোর হিসেবে নয়। গতির সংখ্যা প্রতিবেদিত হলে জোড়া গুণমানের পরিমাপ চাওয়া, যত্নশীল রিভিউয়ের সময়কে সমর্থন করা এবং কাঁচা রিভিউয়ের সময়ে দল তুলনা এড়ানো উচিত, কারণ রিপোজিটরি ও ঝুঁকি আলাদা। গভর্ন্যান্স সংস্থা পরিবর্তনের নিশ্চয়তার অংশ হিসেবে রিভিউয়ের প্রমাণ ব্যবহার করতে পারে, শর্ত হলো তারা মানে যে অনুমোদনের গণনার চেয়ে দলিলভুক্ত, নমুনা-করা রিভিউ প্রক্রিয়া শক্তিশালী।
গ্রাহক ও ব্যবহারকারী
গ্রাহকেরা পুল রিকোয়েস্ট দেখেন না, তবু ফল অনুভব করেন: একটি সংশোধন কত তাড়াতাড়ি আসে এবং একটি রিলিজ কত ঘন ঘন নতুন ত্রুটি আনে। ছোট রিভিউয়ের অপেক্ষা জরুরি সংশোধনকে তাঁদের কাছে আগে পৌঁছাতে সাহায্য করে, আর চিন্তাশীল রিভিউ তাঁদের থেকে ত্রুটি দূরে রাখতে সাহায্য করে। যে সেবার প্রকাশিত রিলিজ বা ত্রুটির ইতিহাস আছে, সেখানে সময়ের সঙ্গে দল কম রিভার্ট ও কম বারবার সংশোধন দেখালে গ্রাহকেরা উপকৃত হন।
বাস্তবে: সেবা ব্যবস্থাপনার একটি উদাহরণ
একটি আঞ্চলিক হাসপাতালের আইটি বিভাগ একটি রোগীর অ্যাপয়েন্টমেন্ট ওয়েব সেবা চালায়, যা সাতজনের একটি পণ্য দল বানিয়েছে এবং একটি ছোট সাইট রিলায়েবিলিটি গোষ্ঠী পরিচালনা করে। এই উদাহরণের সব সংখ্যা দৃষ্টান্তমূলক।
একটি ত্রৈমাসিক পর্যালোচনায় দল দেখে তার রিভিউ সাইকল টাইমের মধ্যমান ২৬ কাজের ঘণ্টা এবং ৮৫তম পার্সেন্টাইল ৭১ কাজের ঘণ্টা (দৃষ্টান্তমূলক)। চক্র ভাঙলে দেখা যায় প্রথম রিভিউয়ের সময়ের মধ্যমান ১৯ কাজের ঘণ্টা, তাই বেশিরভাগ বিলম্ব অপেক্ষা। পুল রিকোয়েস্টের আকারের মধ্যমান ১৮০ লাইন এবং ৮৫তম পার্সেন্টাইল ৯০০ লাইন (দৃষ্টান্তমূলক), এবং দুজন সবচেয়ে ব্যস্ত পর্যালোচক ৬৮ শতাংশ রিভিউ সামলান (দৃষ্টান্তমূলক)। মার্জ-পরবর্তী সংশোধনের হার ৯ শতাংশ (দৃষ্টান্তমূলক)।
দল তিনটি চুক্তি করে। তারা একটি দৈনিক ৩০ মিনিটের রিভিউ স্লট ঠিক করে, কর্মচুক্তিতে এক কার্যদিবসের মধ্যে প্রথম সাড়ার প্রত্যাশা লেখে, এবং প্রতি সপ্তাহে একটি "আগে রিভিউ" দায়িত্ব ঘোরায়। তারা বড় কাজের জন্য একটি কাটার অভ্যাসও গ্রহণ করে, ফিচার টগল ব্যবহার করে যাতে আংশিক ফিচার নিরাপদে মার্জ হতে পারে। তারা আকারের সীমা বা প্রথম রিভিউয়ের সময়ের লক্ষ্য ঠিক করে না।
দুই মাস পরে প্রথম রিভিউয়ের সময়ের মধ্যমান ৬ কাজের ঘণ্টায় নামে এবং রিভিউ সাইকল টাইমের ৮৫তম পার্সেন্টাইল ৩৪ কাজের ঘণ্টায় নামে (দৃষ্টান্তমূলক)। ভারের কেন্দ্রীভবন ৫২ শতাংশে নামে (দৃষ্টান্তমূলক), এবং মার্জ-পরবর্তী সংশোধনের হার ৯ শতাংশেই থাকে।
দল তখন একটি কারসাজির ঝুঁকি ধরে। অনুমোদনের একটি নমুনায় দেখা যায় অ্যাপয়েন্টমেন্ট-অনুস্মারকের যুক্তি ছোঁয়া পরিবর্তনে প্রায় এক-তৃতীয়াংশ প্রথম সাড়া মিনিটের মধ্যে আসে এবং কেবল "LGTM" পড়ে। গতির লাভ আংশিক বাস্তব এবং আংশিক রাবার স্ট্যাম্প ছিল। মার্জ-পরবর্তী সংশোধনের হার তখনও নড়েনি কারণ প্রভাবিত কোড মাসিক চক্রে চলে। দল কর্মচুক্তি বদলায় যাতে একটি প্রথম সাড়ায় হয় একটি প্রশ্ন, পরিবর্তনের একটি নির্দিষ্ট অংশ নিয়ে মন্তব্য, বা কী যাচাই হয়েছে তার সুস্পষ্ট নোট থাকতে হবে, এবং মন্তব্যহীন অনুমোদনের নমুনা-করা অংশ রিভিউ চার্টে যোগ করে। তারা এও একমত হয় যে রোগী-মুখী অনুস্মারকের যুক্তির পরিবর্তনে দুজন পর্যালোচক লাগবে, যাঁদের একজন পরিচালন গোষ্ঠীর। কারণসহ সিদ্ধান্ত দলের সিদ্ধান্ত লগে যায়।
এজাইল, এআই, অটোমেশন ও বিশ্লেষণ
এজাইল
দ্রুত, ছোট রিভিউ নিরবচ্ছিন্ন ডেলিভারি ও টেকসই গতিকে সমর্থন করে। একটি ব্যবহারিক অভ্যাস হলো প্রথম রিভিউয়ের সময়ের জন্য একটি দলের রীতিতে একমত হওয়া এবং নিয়মিত দলের পর্যালোচনায় বাসি পুল রিকোয়েস্ট নিয়ে কথা বলা। সতর্কতা হলো, লক্ষ্য হিসেবে দেখা রিভিউয়ের গতি রাবার-স্ট্যাম্পিংয়ে নিয়ে যায়, তাই মার্জ-পরবর্তী সংশোধনের সঙ্গে জোড় বাঁধুন।
এআই
এআই-তৈরি পরিবর্তন পুল রিকোয়েস্টের পরিমাণ ও আকার বাড়াতে পারে, এবং এআই রিভিউ টুল প্রথম দেখা দ্রুত করতে পারে। এআই-সহায়তাপ্রাপ্ত পরিবর্তনের জন্য প্রথম রিভিউয়ের সময়কে মার্জ-পরবর্তী সংশোধনের হারের সঙ্গে জোড় বাঁধুন, এবং ব্যক্তি নয়, পর্যালোচকের ভূমিকা অনুযায়ী রিভিউয়ের ভার প্রতিবেদন করুন। সতর্কতা হলো, একটি বটের রিভিউ মন্তব্য রিভিউ হিসেবে গোনা হতে পারে, তাই মানবিক রিভিউ আলাদাভাবে গুনুন।
অটোমেশন
কোড হোস্ট থেকে স্বয়ংক্রিয়ভাবে রিভিউ ইভেন্ট টানুন, এবং মানবিক রিভিউয়ের আগে স্বয়ংক্রিয় যাচাই চালান যাতে মানুষ বিচারে সময় দেয়। যাচাইগুলোকে নিজেই মিথ্যা সতর্কতা এবং তাদের এড়িয়ে যাওয়া ত্রুটি দিয়ে মাপুন। সতর্কতা হলো, ভারী অটোমেশন মানবিক রিভিউকে ভাসাভাসা করতে পারে, কারণ মানুষ ধরে নেয় টুল সবকিছু ধরেছে।
বিশ্লেষণ
আকার, প্রথম রিভিউয়ের সময় ও রিভিউ রাউন্ডের বিন্যাস দল অনুযায়ী দেখান, ব্যক্তি অনুযায়ী কখনও নয়। এটি যে সিদ্ধান্তে তথ্য জোগায় তা হলো রিভিউয়ের ধারণক্ষমতা বা পরিবর্তনের আকারে কোথায় মনোযোগ দরকার। সতর্কতা হলো, এই সংখ্যাগুলো রিভিউ ব্যবস্থা বর্ণনা করে, আর মানুষকে ক্রম দেওয়ার যেকোনো ব্যবহার তাদের ছোট, নিরাপদ, কম কাজের পরিবর্তনের দিকে ঠেলবে।
খাতভিত্তিক দৃষ্টিকোণ
স্টার্টআপ। ছোট দল মিনিটে রিভিউ করতে পারে কারণ সবাই কোড চেনে, আর প্রধান ঝুঁকি সময় কম থাকলে রিভিউ এড়ানো। মেট্রিক অল্প রাখুন: প্রথম রিভিউয়ের সময় ও আকারই যথেষ্ট। ছোট পরিবর্তনের অভ্যাস আগেভাগে গড়ুন, কারণ কোডবেস ও দল বড় হওয়ার পর তা চালু করা অনেক কঠিন।
ছোট ব্যবসা। প্রায়ই এক বা দুজন ডেভেলপার, বা একজন বাইরের সরবরাহকারী সফটওয়্যার রক্ষণাবেক্ষণ করে। রিভিউ একজন সহকর্মী বা সরবরাহকারীর নিজস্ব কর্মী করতে পারেন। সরবরাহকারীদের জিজ্ঞাসা করুন তারা কীভাবে রিভিউ করে এবং পুল রিকোয়েস্টের তথ্য ভাগ করা যায় কি না, এবং কোন পরিবর্তন কে রিভিউ করেছেন তার একটি সরল রেকর্ড রাখুন, কারণ ছোট দলে রিভিউই ভুলের বিরুদ্ধে প্রধান যাচাই।
এন্টারপ্রাইজ। বহু দল, রিপোজিটরি ও অনুমোদনের নিয়ম ব্যাপক তারতম্য তৈরি করে। ঘড়ি ও বাদ দেওয়া আইটেমের সংজ্ঞা আদর্শায়িত করুন যাতে প্ল্যাটফর্মের তথ্য তুলনীয় হয়, কিন্তু কাঁচা রিভিউয়ের সময়ে দলকে ক্রম দেবেন না, কারণ ঝুঁকি ও কোডবেস আলাদা। নিরীক্ষার জন্য চাপানো এমন রিভিউয়ের দাবি থেকে সতর্ক থাকুন যা পুঙ্খানুপুঙ্খতা না বাড়িয়ে অপেক্ষা বাড়ায়, এবং হাতের অনুমোদনকে স্বয়ংক্রিয় যাচাই ও নমুনা-করা রিভিউ দিয়ে প্রতিস্থাপনের সুযোগ খুঁজুন।
সরকার ও জনসেবা খাত। কর্তব্যের পৃথকীকরণ, নিরীক্ষার ট্রেইল ও ক্রয়ের নিয়ম প্রায়ই পরিবর্তনের জন্য স্বাধীন অনুমোদন দাবি করে। এগুলোকে নকশার উপাদান ধরুন: কে কী কখন অনুমোদন করেছেন লিপিবদ্ধ করুন, এবং তারা যে অপেক্ষা তৈরি করে তা মাপুন। যেখানে সরবরাহকারীরা কোড লেখে, সেখানে চুক্তিতে রিভিউয়ের প্রমাণ ও তথ্যে প্রবেশাধিকার নির্দিষ্ট করুন (বিষয় 8.5, নিয়ন্ত্রক ও সরকারি প্রতিবেদন দেখুন)।
ব্যবসায়িক যুক্তি: প্রেরণা, ROI ও TCO
প্রেরণা হলো ডেলিভারির সেই অংশ ছোট করা যা একই সঙ্গে ধীর ও নিয়ন্ত্রণযোগ্য, সহকর্মী-রিভিউয়ের সুবিধা রেখে: কম ত্রুটি, ভাগ করা জ্ঞান এবং একটি নিরীক্ষার ট্রেইল। অপেক্ষারত পুল রিকোয়েস্ট শেষ হওয়া কাজ ব্যবহারকারীদের কাছ থেকে আটকে রাখে, লেখকদের প্রসঙ্গ-বদলের খরচ বাড়ায়, এবং শাখা পুরোনো হলে মার্জ দ্বন্দ্বের সম্ভাবনা বাড়ায়। অপেক্ষা কমালে তাই দ্রুততর ডেলিভারি, কম পুনঃকাজ ও কম হতাশায় প্রতিদান আসে।
সংস্করণ নিয়ন্ত্রণ প্ল্যাটফর্ম ইভেন্টের ইতিহাস ও একটি API দিলে এই মেট্রিক সংগ্রহের খরচ কম। প্রধান খরচ হলো ঘড়ি ও বাদ দেওয়া আইটেম সংজ্ঞায়িত করা, প্রতিবেদন বানানো বা কনফিগার করা এবং নিয়মিত সংখ্যা পর্যালোচনা করার সময়। বড় খরচ আচরণগত: দ্রুত রিভিউ করতে মানুষ যে সময় দেয়, যা অন্য কাজের সঙ্গে প্রতিযোগিতা করে। সেই সময়ই প্রকৃত বিনিয়োগ, এবং তাকে বিনামূল্যের না ধরে বাজেট করা উচিত।
প্রতিদান দেখা দেয় ছোট রিভিউ সাইকল টাইম, কম বাসি পুল রিকোয়েস্ট এবং স্থির বা কমতে থাকা মার্জ-পরবর্তী সংশোধনের হারে। আগে থেকে নির্দিষ্ট শতাংশ উন্নতির দাবি করবেন না, কারণ ফল নির্ভর করে সূচনা-বিন্দু ও দলের ওপর। বিশ্বাসযোগ্য যুক্তি অন্য সংগঠনের সংখ্যা উদ্ধৃত না করে দলের নিজের আগে-পরের বিন্যাস, তার গুণমানের সমতুল্যসহ, তুলনা করে। ২০১৮ সালের বই Accelerate প্রযুক্তিগত ও সাংস্কৃতিক চর্চাকে ডেলিভারি কার্যসম্পাদনের সঙ্গে যুক্ত করা গবেষণা প্রতিবেদন করে এবং সাধারণ যুক্তির জন্য একটি যুক্তিসংগত উৎস, কিন্তু আপনার দলের সংখ্যা আসে আপনার নিজের তথ্য থেকে।
অ্যান্টি-প্যাটার্ন ও ফাঁদ
- পর্যালোচক বা লেখককে ক্রম দেওয়া। সম্পন্ন রিভিউ বা পরিবর্তিত লাইনের ব্যক্তিগত লিডারবোর্ড সহযোগিতা নষ্ট করে। দল-স্তরে প্রতিবেদন করুন এবং দলের অভ্যাস সমন্বয় করতে সংখ্যা ব্যবহার করুন।
- গুণমানের সমতুল্য ছাড়া প্রথম রিভিউয়ের সময়ের লক্ষ্য। ফল রাবার স্ট্যাম্প। প্রতিটি গতির চার্টের পাশে মার্জ-পরবর্তী সংশোধনের হার এবং মন্তব্যহীন অনুমোদনের একটি নমুনা দেখান।
- কঠোর আকারের সীমা ঠিক করা। দলগুলো মেনে চলতে কৃত্রিমভাবে কাজ ভাঙে। আকারকে আলাপ হিসেবে ব্যবহার করুন এবং বদলে কাটার কৌশল শেখান।
- শূন্য মন্তব্যকে সাফল্য ভাবা। পরীক্ষা না করা অনুমোদন আস্থা বা অমনোযোগ প্রতিফলিত করতে পারে। এমন পুল রিকোয়েস্টের নমুনা নিন এবং একসঙ্গে পড়ুন।
- বটের কার্যকলাপকে রিভিউ গোনা। স্বয়ংক্রিয় মন্তব্য অপেক্ষা ছোট দেখায়। ঘড়ি ও ভারের পরিমাপ থেকে বট বাদ দিন।
- সময় অঞ্চল ও ক্যালেন্ডার উপেক্ষা করা। কাঁচা ঘড়ির সময় সপ্তাহান্ত ও অঞ্চলান্তরের অপেক্ষাকে ধীর রিভিউ দেখায়। কাজের ঘণ্টা ব্যবহার করুন এবং ক্যালেন্ডারের নাম দিন।
- বাসি তালিকা বাড়তে দেওয়া। পুরোনো পুল রিকোয়েস্টে মার্জ দ্বন্দ্ব জমে এবং প্রসঙ্গ হারায়। তালিকা সাপ্তাহিক পর্যালোচনা করুন এবং প্রতিটি আইটেম হয় মার্জ, পুনঃকাজ বা কারণসহ বন্ধ করুন।
পরিপক্বতার মডেল
| মাত্রা | 1 সূচনা | 2 বিকাশ | 3 মানসম্মত | 4 পরিচালিত | 5 সুসমন্বিত |
|---|---|---|---|---|---|
| সংজ্ঞা ও ঘড়ি | রিভিউয়ের সময় অনুমান বা অনুভূতিতে প্রতিবেদিত | কিছু দল নিজের নিয়মে প্ল্যাটফর্ম থেকে সময় রপ্তানি করে | বট, ড্রাফট ও ক্যালেন্ডারের বাদ দেওয়াসহ প্রতিটি ঘড়ির একটি লিখিত সংজ্ঞা | সংজ্ঞা ছন্দ ধরে পর্যালোচিত; পরিবর্তন কারণসহ লগ করা | সংজ্ঞা দল ও সরবরাহকারীদের মধ্যে সারিবদ্ধ এবং সিদ্ধান্তে তথ্য জোগানো বন্ধ হলে সংশোধিত |
| রিভিউ চর্চা | কেউ লক্ষ করলে রিভিউ হয় | কিছু দলে অনানুষ্ঠানিক রীতি | অনুরোধ, সাড়ার প্রত্যাশা এবং রিভিউ কী ঢাকে তা নিয়ে লিখিত কর্মচুক্তি | তথ্য থেকে রীতি সমন্বিত; জ্ঞান ভাগ ও ঝুঁকির অংশ ট্র্যাক করা | রিভিউ চর্চা দল ও সরবরাহকারীদের মধ্যে সমন্বিত, নিয়মিত যাচাই অটোমেশন সামলায় |
| গুণমানের সমতুল্য | রিভিউ ও ত্রুটির মধ্যে কোনো যোগ নেই | মাঝেমধ্যে মার্জ-পরবর্তী সংশোধন দেখা | রিভিউয়ের গতির পাশে মার্জ-পরবর্তী সংশোধনের হার দেখানো | রক্ষাবেষ্টনী নিয়মিত পর্যালোচিত; নমুনা অনুমোদন পড়া | রিভিউয়ের প্রমাণ সেবাজুড়ে পরিবর্তনের নিশ্চয়তা ও ইনসিডেন্ট শিক্ষার সঙ্গে যুক্ত |
| উন্নয়নে ব্যবহার | সংখ্যা অব্যবহৃত | কিছু রেট্রোস্পেকটিভে দেখানো | মালিক দল দ্বারা নির্দিষ্ট ছন্দে পর্যালোচিত | ফাঁক পরিকল্পিত, সম্পদযুক্ত উন্নয়ন-কাজে নিয়ে যায় | উন্নয়নের ধারণা দল থেকে ভাগ করা চর্চায় যায় এবং ফিরে আসে |
চেকলিস্ট
- প্রথম রিভিউয়ের সময় ও রিভিউ সাইকল টাইমের ঘড়ি শুরু, থামা ও বাদ দেওয়াসহ লেখা আছে।
- বট, ড্রাফট এবং মার্জ ছাড়া বন্ধ পুল রিকোয়েস্ট বাদ বা আলাদাভাবে গোনা, এবং নিয়ম দৃশ্যমান।
- সময় কাজের ঘণ্টায় মধ্যমান ও একটি উচ্চ পার্সেন্টাইল হিসেবে প্রতিবেদিত।
- পুল রিকোয়েস্টের আকার জেনারেটেড ও ভেন্ডর ফাইলের জন্য সম্মত ignore তালিকাসহ মাপা।
- রিভিউ কীভাবে অনুরোধ করা হয় এবং প্রথম সাড়া কত দ্রুত প্রত্যাশিত তা নিয়ে দলের একটি লিখিত চুক্তি আছে।
- রিভিউ ভারের কেন্দ্রীভবন শুধু দল-স্তরে প্রতিবেদিত।
- রিভিউয়ের গতির একই চার্টে একটি মার্জ-পরবর্তী সংশোধনের হার বা অন্য গুণমানের সমতুল্য দেখানো।
- প্রতি মাসে মন্তব্যহীন ও অতি দ্রুত অনুমোদনের একটি নমুনা পড়া হয়।
- বাসি পুল রিকোয়েস্টের তালিকা সাপ্তাহিক পর্যালোচিত।
- রিভিউয়ের তথ্য রেট্রোস্পেকটিভে ব্যবহৃত হয়, ব্যক্তিগত মূল্যায়নে নয়।
- একক যোগ্য পর্যালোচকের কোডের অংশগুলো তালিকাভুক্ত এবং তাদের একটি পরিকল্পনা আছে।
এআই প্রম্পট
রিভিউ মেট্রিকের ঘড়ির সংজ্ঞার খসড়া করুন।
আমি [দল বা রিপোজিটরি]-র জন্য রিভিউ মেট্রিক সংজ্ঞায়িত করতে চাই। আমাদের প্ল্যাটফর্ম
[ভার্সন কন্ট্রোল প্ল্যাটফর্ম] এবং আমাদের ওয়ার্কফ্লো [বর্ণনা করুন: ড্রাফট পুল রিকোয়েস্ট,
প্রয়োজনীয় অনুমোদন, মার্জের নিয়ম, ব্যবহৃত বট]। প্রথম রিভিউয়ের সময় ও রিভিউ সাইকল টাইমের
নির্ভুল সংজ্ঞার খসড়া করুন, প্রতিটি ঘড়ি শুরু ও থামানোর ইভেন্ট, কী বাদ (বট, ড্রাফট, মার্জ ছাড়া
বন্ধ), [সময় অঞ্চল ও কাজের ক্যালেন্ডার]-এর জন্য কাজের ঘণ্টা কীভাবে সামলানো হয়, এবং কোন
পার্সেন্টাইল প্রতিবেদন করবেন তা উল্লেখ করে। বেঞ্চমার্ক মান বা টুলের বৈশিষ্ট্য বানাবেন না।
আপনার অনুমান এবং সংজ্ঞা শেষ করতে আমাকে যে প্রশ্নের উত্তর দিতে হবে তা তালিকা করুন।
রিভিউয়ের তথ্যের একটি রপ্তানি বিশ্লেষণ করুন।
এখানে [সময়কাল] ধরে [দল]-এর মার্জ করা পুল রিকোয়েস্টের একটি বেনামি রপ্তানি, ঘর
[ঘরের তালিকা, যেমন প্রস্তুতির সময়, প্রথম রিভিউয়ের সময়, মার্জের সময়, পরিবর্তিত লাইন,
রিভিউ রাউন্ড, যুক্ত সংশোধনের পতাকা]: [তথ্য বা সারসংক্ষেপ পেস্ট করুন]। প্রতিটি সময়ের
পরিমাপ ও আকারের জন্য মধ্যমান ও ৮৫তম পার্সেন্টাইল হিসাব করুন, রিভিউ চক্রকে অপেক্ষা
ও রিভিউতে ভাগ করুন, এবং আলাপের যোগ্য ধারা নির্দেশ করুন। ব্যক্তিদের ক্রম দেবেন না এবং
বাইরের বেঞ্চমার্কের সঙ্গে তুলনা করবেন না। আপনার অনুমান এবং লক্ষ করা তথ্যের মানের
সমস্যা তালিকা করুন।
আমাদের রিভিউ মেট্রিকের কারসাজির ঝুঁকি খুঁজুন।
আমাদের দল এই রিভিউ মেট্রিক প্রতিবেদন করে: [মেট্রিকের তালিকা ও প্রতিটি কীভাবে হিসাব
করা]। আমাদের ওপর চাপ [যেমন একটি রিলিজের সময়সীমা, নেতৃত্বের লক্ষ্য, সরবরাহকারীর
চুক্তি]। প্রতিটি মেট্রিকের জন্য রিভিউ উন্নত না করে তাকে উন্নত করার বিশ্বাসযোগ্য উপায়,
প্রতিটির আগাম লক্ষণ এবং তা ধরবে এমন একটি জোড়া রক্ষাবেষ্টনী মেট্রিক বা চর্চা বর্ণনা করুন।
পরিসংখ্যান বানাবেন না। আপনার অনুমান এবং ঝুঁকিগুলোর ক্রম দিতে আপনার কী জানা দরকার
তা বলুন।
রিভিউ প্রবাহের ওপর একটি রেট্রোস্পেকটিভের প্রস্তুতি নিন।
রিভিউ প্রবাহের ওপর [দল]-এর জন্য ৪৫ মিনিটের একটি রেট্রোস্পেকটিভের কার্যসূচি প্রস্তুত
করুন। ইনপুট: প্রথম রিভিউয়ের সময় [মান], রিভিউ সাইকল টাইম [মান], মধ্যমান আকার
[মান], ভারের কেন্দ্রীভবন [মান], এবং মার্জ-পরবর্তী সংশোধনের হার [মান], সবই তাদের
সংজ্ঞাসহ চিহ্নিত। কারণ প্রকাশ করবে এমন প্রশ্ন, [সময়কাল] ধরে দল চালাতে পারে এমন একটি
ছোট পরীক্ষা, এবং পরীক্ষার সময় দেখার গুণমানের সংকেত প্রস্তাব করুন। কারণ বা লক্ষ্য
বানাবেন না। আপনার অনুমান এবং আমার যে তথ্য আনা উচিত তা তালিকা করুন।
এআই স্কিল
- Service Management Metrics skill: সম্পর্কিত প্রবাহ বা গুণমানের মেট্রিক কোন বিষয় সংজ্ঞায়িত করে এবং একটি রিভিউ মেট্রিকের পাশে কোন রক্ষাবেষ্টনী থাকা উচিত তা খুঁজে পেতে ব্যবহার করুন।
- Service Management Metrics maintainer skill: এই বিষয়ের সম্পাদনা কাঠামো, কারসাজির সারণি ও আন্তঃসূত্র সামঞ্জস্যপূর্ণ রাখে কি না যাচাই করতে ব্যবহার করুন।
মূল শিক্ষা
- বেশিরভাগ রিভিউ বিলম্ব অপেক্ষা, তাই প্রথম রিভিউয়ের সময় ও রিভিউ সাইকল টাইম কাজের ঘণ্টায় বিন্যাস হিসেবে মাপুন।
- ছোট পুল রিকোয়েস্ট দ্রুততর ও আরও যত্নসহকারে পর্যালোচিত হয়; আকারের সীমা না চাপিয়ে কাটা শেখান।
- প্রতিটি গতির পরিমাপকে মার্জ-পরবর্তী সংশোধনের হারের মতো একটি গুণমানের সমতুল্যের সঙ্গে জোড় বাঁধুন, এবং দুটি একসঙ্গে পড়ুন।
- রিভিউয়ের ভারকে দলের ধারণক্ষমতা হিসেবে দেখুন এবং কেন্দ্রীভবন দল-স্তরে প্রতিবেদন করুন, মানুষের ক্রম হিসেবে কখনও নয়।
- রিভিউ মেট্রিক রেট্রোস্পেকটিভের প্রশ্ন, এবং কাজের মালিক দলকে সেবা করে।
তথ্যসূত্র ও আরও পড়ার জন্য
- Forsgren, N., Humble, J., and Kim, G., Accelerate: The Science of Lean Software and DevOps, IT Revolution, 2018.
- Forsgren, N., Storey, M.-A., Maddila, C., Zimmermann, T., Houck, B., and Butler, J., "The SPACE of Developer Productivity," ACM Queue, 2021.
- Google, Code Review Developer Guide, Google Engineering Practices documentation, https://google.github.io/eng-practices/review/
- Bacchelli, A., and Bird, C., "Expectations, Outcomes, and Challenges of Modern Code Review," Proceedings of the 35th International Conference on Software Engineering (ICSE), 2013.
- Vacanti, D. S., Actionable Agile Metrics for Predictability: An Introduction, Daniel S. Vacanti, Inc., 2015.
- Schwaber, K., and Sutherland, J., The Scrum Guide, Scrum.org and Scrum Inc., 2020.
- Goodhart, C. A. E., "Problems of Monetary Management: The U.K. Experience," in Papers in Monetary Economics, Reserve Bank of Australia, 1975.
- Wikipedia, Pull request.
- Wikipedia, Version control.
- Wikipedia, Code review.
- Wikipedia, Goodhart's law.
- Wikipedia, Continuous integration.
- Wikipedia, Trunk-based development.
- Wikipedia, Pair programming.
- Wikipedia, Static program analysis.