جائزہ اور محرکات

Pull request (پل ریکویسٹ) version control (ورژن کنٹرول) ریپوزٹری کی ایک برانچ سے دوسری میں تبدیلیوں کا مجموعہ ضم کرنے کی تجویز ہے، ساتھ اس بارے میں گفتگو کے کہ اسے ضم ہونا چاہیے یا نہیں۔ بہت سی ٹیموں میں یہ "مصنف سمجھتا ہے کہ یہ کام کرتا ہے" اور "ٹیم متفق ہے کہ یہ جہاز پر جا سکتا ہے" کے درمیان رسمی دروازہ ہے۔ گفتگو code review (کوڈ کے جائزے) کی ایک شکل ہے: مصنف کے علاوہ کوئی شخص تبدیلی پڑھتا ہے، سوالات پوچھتا ہے، اور اسے منظور کرتا ہے یا نظرِ ثانی مانگتا ہے۔ کچھ پلیٹ فارم اسی کو مرج ریکویسٹ کہتے ہیں؛ یہ موضوع دونوں کے لیے "پل ریکویسٹ" استعمال کرتا ہے۔

جائزے کی پیمائش ایک سادہ وجہ سے قابل ہے۔ فراہمی کے بہاؤ کے نقطۂ نظر میں کام کا آئٹم اپنی زندگی کا بیشتر حصہ انتظار میں گزارتا ہے، اور جائزہ ان انتظاروں میں سے ہے جو پوری طرح ٹیم کے قابو میں ہیں۔ مشترکہ پلیٹ فارم کی رکاوٹ یا بیرونی انحصار کے لیے دوسرے لوگوں کو بدلنا ہوتا ہے۔ جو پل ریکویسٹ پہلی نظر کے لیے دو دن انتظار کرے اسے بدلنے کے لیے صرف ٹیم کی اپنی عادتیں بدلنا کافی ہیں۔ اس کتاب کی بہاؤ کی پیمائشیں (موضوع 2.1، بہاؤ کی پیمائشیں اور موضوع 2.2، لیڈ ٹائم، سائیکل ٹائم اور بہاؤ کی کارکردگی دیکھیں) عمومی لغت دیتی ہیں۔ یہ موضوع دائرے کے ایک مرحلے پر زوم کرتا ہے اور اسے اپنے آلات دیتا ہے۔

ایجائل اور ITIL کے نقطۂ نظر یہاں مفید طریقے سے ملتے ہیں۔ ایجائل نقطۂ نظر سے جائزہ فیڈ بیک کا دائرہ اور سکھانے کا ذریعہ ہے۔ یہ کوڈ بیس کا علم پھیلاتا ہے، خرابیاں جلد پکڑتا ہے، اور ٹیم کے کام کرنے کے معاہدوں اور تکمیل کی تعریف کو نافذ کرتا ہے۔ ITIL کے نقطۂ نظر سے یہی سرگرمی کئی طریقوں کو سہارا دیتی ہے۔ ITIL 4 میں سافٹ ویئر ڈیولپمنٹ اور مینجمنٹ کا طریقہ بتاتا ہے کہ سافٹ ویئر کیسے بنتا اور جانچا جاتا ہے، تبدیلی کی فعالیت بتاتی ہے کہ تبدیلیوں کا اندازہ اور اجازت کیسے ہوتی ہے، اور ڈیپلائمنٹ مینجمنٹ بتاتی ہے کہ تبدیلیاں زندہ ماحول تک کیسے پہنچتی ہیں۔ ساتھی سے جائزہ شدہ پل ریکویسٹ، بہت سی تنظیموں کے لیے، اس بات کا ثبوت ہے کہ معیاری تبدیلی کا ریلیز سے پہلے اندازہ لگایا گیا۔ جائزے کو ناپی جانے والی، بہتر ہونے والی سرگرمی سمجھنا دونوں نقطۂ نظر کی خدمت کرتا ہے: ایجائل ٹیم تیز فیڈ بیک چاہتی ہے، اور ITIL کا طریقہ قابلِ اعتماد یقین دہانی چاہتا ہے کہ تبدیلیاں جانچی گئیں۔

جو خطرہ پورے وقت ذہن میں رکھنا ہے وہ یہ ہے کہ جائزے کی رفتار اور جائزے کا معیار آسانی سے الگ ہو جاتے ہیں۔ ٹیم ہر چیز کو دیکھتے ہی منظور کر کے پہلے جائزے کا وقت آدھا کر سکتی ہے، اور ڈیش بورڈ فتح دکھائے گا جبکہ کوڈ بیس بگڑتا ہے۔ Goodhart's law (گڈہارٹ کا قانون) اس میٹرک خاندان پر غیر معمولی قوت سے لاگو ہوتا ہے (موضوع 1.2، گڈہارٹ کا قانون اور میٹرکس کی نفسیات دیکھیں)، کیونکہ اعداد جمع کرنے میں سستے، ہر ایک کو نظر آنے والے، اور اس چیز کو بدلے بغیر ہلانے میں انتہائی آسان ہیں جس کی وہ نمائندگی کرتے ہیں۔ نیچے کی ہر سفارش اسی کو ذہن میں رکھ کر لکھی گئی ہے۔

مصنف نے پل ریکویسٹ کھولی اور جائزہ لینے والا اس کا اندازہ لگاتا ہے۔ جائزے کا دور "مصنف پش کرتا ہے، جائزہ لینے والا جواب دیتا ہے" کا ایک چکر ہے۔ دوبارہ کام وہ تبدیلی ہے جو جائزے کے تبصرے کے بعد، یا ضم کے بعد، اس کو درست کرنے کے لیے کی جائے جو پہلے ورژن نے غلط کیا۔ مسلسل انضمام (continuous integration، CI) کام کو اکثر مشترکہ لائن میں ضم کرنے اور ہر انضمام کو خودکار طور پر جانچنے کا عمل ہے؛ دیکھیں continuous integration۔

اس موضوع کے تمام میٹرکس ٹیموں اور ریپوزٹریز کو بیان کرتے ہیں۔ وہ جائزہ لینے والوں یا مصنفین کی درجہ بندی کبھی نہیں کرتے۔ فرد کی سطح کے جائزوں کی گنتیاں نکالنا آسان اور استعمال کرنے کی ترغیب دینے والا ہے، اور ایسا کرنا تعاون کے عمل کو مقابلے میں بدل دیتا ہے (موضوع 9.1، ٹیم کی صحت اور ڈویلپر کا تجربہ دیکھیں)۔

بنیادی اصول

  • انتظار جائزے پر حاوی ہے۔ زیادہ تر ٹیموں میں جائزے کے وقت کا سب سے بڑا حصہ پل ریکویسٹ کا ان پڑھا پڑا رہنا ہے، جائزہ لینے والے کے شروع کرنے کے بعد کی گفتگو نہیں۔ گفتگو سے پہلے انتظار ناپیں۔
  • چھوٹی تبدیلیوں کا جائزہ تیز اور بہتر ہوتا ہے۔ سائز ان چند ذرائع میں سے ہے جو رفتار اور باریکی دونوں ایک ساتھ بہتر کرتے ہیں، کیونکہ جائزہ لینے والا چھوٹی تبدیلی کو ذہن میں رکھ سکتا ہے۔
  • باریکی کے بغیر رفتار بہتری نہیں۔ اس موضوع کی ہر رفتار کی پیمائش کو معیار کا ساتھی چاہیے، اور جوڑی کو ساتھ پڑھا جاتا ہے۔
  • جائزہ ٹیم کی صلاحیت ہے، ذاتی نہیں۔ بوجھ ٹیم میں پھیلنا چاہیے۔ جو میٹرک ارتکاز دکھائے وہ ٹیم کے ڈیزائن کے مسئلے کی طرف اشارہ کرتا ہے، کسی شخص کی طرف نہیں جسے سراہا یا الزام دیا جائے۔
  • اوسط پر تقسیم بہتر ہے۔ جائزے کے اوقات میں اٹکی ہوئی پل ریکویسٹس کی لمبی دم ہوتی ہے، اس لیے وسطانیہ اور اونچا پرسنٹائل رپورٹ کریں (موضوع 1.6، خدمات کے میٹرکس کے لیے شماریاتی خواندگی دیکھیں)۔
  • گھڑی متعین کریں، پھر اسے چھوڑ دیں۔ بتائیں کہ گھڑی کب شروع اور رکتی ہے، کون سے واقعات اسے روکتے ہیں، اور کون سی خودکار سرگرمی خارج ہے، اور اسے وہاں لکھیں جہاں ڈیٹا رہتا ہے (موضوع 1.5، ڈیٹا کے ذرائع اور پیمائشی آلات دیکھیں)۔
  • جائزے کے میٹرکس اس ٹیم کی خدمت کرتے ہیں جو کام کی مالک ہے۔ وہ ٹیم کے اپنے ریٹرو اسپیکٹو کا ان پٹ ہیں، کسی اور کے لیے اسکور کارڈ نہیں۔

میٹرکس کی تعریفیں

نیچے کی گھڑیاں فرض کرتی ہیں کہ ورژن کنٹرول پلیٹ فارم کھولنے، جائزے کی درخواست، تبصروں، منظوریوں، پشز اور ضم کے ایونٹ کے اوقات ریکارڈ کرتا ہے۔ ڈرافٹس، بوٹس کی کھولی ہوئی پل ریکویسٹس، اور بغیر ضم بند کی گئی پل ریکویسٹس خارج ہیں جب تک کوئی قطار نہ کہے۔ "کام کے گھنٹے" کا مطلب ٹیم کے اعلان شدہ کام کے گھنٹے ہیں، تاکہ جمعے کی شام کھولی گئی پل ریکویسٹ پر ہفتہ وار تعطیل کا انتظار نہ جمع ہو۔

میٹرک تعریف فارمولا اکائی ڈیٹا کا ذریعہ ITIL طریقہ ایجائل میں مماثل وقفہ
پہلے جائزے کا وقت پل ریکویسٹ کے جائزے کے لیے تیار ہونے اور پہلے بامعنی انسانی جواب کے درمیان انتظار گھڑی تب شروع ہوتی ہے جب پل ریکویسٹ ڈرافٹ سے نکلے یا تیار کھلے، اور مصنف کے علاوہ کسی کے پہلے جائزے کے تبصرے، تبدیلی کی درخواست یا منظوری پر رکتی ہے؛ بوٹ اور مصنف کے تبصرے اور محض لیبل کی تبدیلیاں خارج۔ کام کے گھنٹوں میں وسطانیہ اور 85واں پرسنٹائل رپورٹ کریں کام کے گھنٹے ورژن کنٹرول پلیٹ فارم کی ایونٹ ہسٹری سافٹ ویئر ڈیولپمنٹ اور مینجمنٹ؛ تبدیلی کی فعالیت جائزے کی جوابدہی پر کام کرنے کا معاہدہ؛ جاری کام کا بہاؤ ہفتہ وار
جائزے کا سائیکل ٹائم جائزے کے لیے تیار ہونے سے ضم تک کل وقت گھڑی تب شروع ہوتی ہے جب پل ریکویسٹ جائزے کے لیے تیار ہو اور ضم پر رکتی ہے؛ بغیر ضم بند پل ریکویسٹس خارج اور الگ گنی جاتی ہیں۔ کام کے گھنٹوں میں وسطانیہ اور 85واں پرسنٹائل رپورٹ کریں کام کے گھنٹے ورژن کنٹرول پلیٹ فارم کی ایونٹ ہسٹری ڈیپلائمنٹ مینجمنٹ؛ تبدیلی کی فعالیت ٹیم بورڈ پر جائزے کے مرحلے کا سائیکل ٹائم ہفتہ وار
پل ریکویسٹ کا سائز پل ریکویسٹ میں تبدیلی کی مقدار شامل کی گئی لائنیں جمع حذف کی گئی لائنیں، ریپوزٹری کے آئی گنور قواعد میں درج پیدا شدہ فائلیں، لاک فائلیں، وینڈرڈ کوڈ اور خالص نام کی تبدیلیاں خارج۔ فی ضم شدہ پل ریکویسٹ وسطانیہ اور 85واں پرسنٹائل رپورٹ کریں بدلی گئی لائنیں ورژن کنٹرول پلیٹ فارم کے ڈف کے اعداد سافٹ ویئر ڈیولپمنٹ اور مینجمنٹ چھوٹا بیچ سائز؛ اسٹوریز کی تقسیم ہفتہ وار
جائزے کے دور ضم سے پہلے مصنف کے پش اور جائزہ لینے والے کے جواب کے چکروں کی تعداد فی ضم شدہ پل ریکویسٹ الگ "تبدیلیوں کی درخواست" یا تبصرہ-پھر-پش چکروں کی گنتی؛ پہلی جمع آوری دور صفر ہے اور خودکار جانچ کی ناکامیاں خارج۔ وسطانیہ اور 85واں پرسنٹائل رپورٹ کریں گنتی ورژن کنٹرول پلیٹ فارم کے جائزے اور پش ایونٹس مسلسل بہتری؛ سافٹ ویئر ڈیولپمنٹ اور مینجمنٹ جائزے کے مرحلے میں دوبارہ کام کا اشارہ؛ تکمیل کی تعریف ہفتہ وار
جائزے کے بوجھ کا ارتکاز ٹیم میں جائزے کا کام کتنا غیر یکساں پھیلا ہے لڑھکتے 4 ہفتوں میں دو مصروف ترین جائزہ لینے والوں کے مکمل کیے گئے جائزوں کا ٹیم کے مکمل جائزوں میں حصہ؛ اپنی پل ریکویسٹ کے جائزے اور بوٹ جائزے خارج۔ ٹیم کے لیے رپورٹ، نام سے کبھی نہیں فیصد ورژن کنٹرول پلیٹ فارم کے جائزے کے ایونٹس، ٹیم تک جمع مسلسل بہتری؛ علمی انتظام مشترکہ کوڈ کی ملکیت؛ اجتماعی ملکیت ماہانہ
پرانی پل ریکویسٹس کی گنتی ٹیم کی طے شدہ حد سے زیادہ کھلی پل ریکویسٹس وہ کھلی پل ریکویسٹس جو ڈرافٹ نہیں اور جن کی جائزے کے لیے تیار ہونے سے عمر ٹیم کی حد سے بڑھ گئی، سنیپ شاٹ کے وقت گنی گئی؛ ڈرافٹس خارج گنتی ورژن کنٹرول پلیٹ فارم کی کھلی پل ریکویسٹس کی فہرست تبدیلی کی فعالیت؛ مسلسل بہتری کام کے آئٹم کی عمر؛ WIP کی حد ہفتہ وار
ضم کے بعد اصلاح کی شرح ضم شدہ پل ریکویسٹس کا وہ حصہ جس کے فوراً بعد اصلاحی تبدیلی آئی ضم شدہ پل ریکویسٹس جن کے 14 دن کے اندر اسی تبدیلی سے جڑی اصلاح، ریورٹ یا ہاٹ فکس آئی / مدت میں ضم شدہ پل ریکویسٹس؛ اس طرح لیبل شدہ منصوبہ بند فالو اپ کام خارج فیصد ورژن کنٹرول کی ہسٹری، جڑے ایشوز، اور انسیڈنٹ یا تبدیلی کے ریکارڈ تبدیلی کی فعالیت؛ انسیڈنٹ مینجمنٹ بنایا گیا معیار؛ تکمیل کی تعریف ماہانہ

پہلے جائزے کا وقت سب سے بڑا اہرم ہے اور وہ میٹرک جس سے زیادہ تر ٹیموں کو شروع کرنا چاہیے۔ جائزے کا سائیکل ٹائم اس کا نتیجے کی پیمائش ہے اور موضوع 2.2 میں زیرِ بحث لمبے لیڈ ٹائم کا حصہ ہے۔ 14 دن کی ونڈو اور پرانی پل ریکویسٹ کی حد مثالیں ہیں؛ ہر ٹیم وہ قدریں چنتی ہے جو اس کی ریلیز کی رفتار کے مطابق ہوں اور انہیں لکھ لیتی ہے۔ جہاں اعداد وسیع تر فراہمی کی تصویر میں جائیں وہاں ڈورا خاندان (موضوع 2.8، ڈورا میٹرکس دیکھیں) اور تبدیلی کی ناکامی کی پیمائشیں (موضوع 4.4، تبدیلی کی ناکامی اور دوبارہ کام دیکھیں) سنبھال لیتی ہیں۔

سفارشات

کام سے پہلے انتظار ناپیں

1. پہلے جائزے کے وقت سے شروع کریں۔ یہ عموماً جائزے کے وقت کا سب سے بڑا حصہ ہے اور بہتر کرنے میں سب سے سستا۔ اسے پلیٹ فارم کی ایونٹ ہسٹری سے ناپیں تاکہ کسی کو کچھ درج نہ کرنا پڑے۔ وسطانیہ اور اونچا پرسنٹائل رپورٹ کریں، کیونکہ تین گھنٹے کا وسطانیہ اور چار دن کا 95واں پرسنٹائل کا مطلب ہے کہ کچھ تبدیلیاں بھلائی جا رہی ہیں۔

2. گھڑی سے بوٹس اور ڈرافٹس کو خارج کریں، اور بتائیں۔ خودکار جانچیں، انحصار اپ ڈیٹ کرنے والے بوٹس، اور فارمیٹنگ کے ٹولز سیکنڈوں میں تبصرے بناتے ہیں، اور انہیں گننا انتظار کو بہترین دکھاتا ہے۔ گھڑی تب شروع کریں جب مصنف تبدیلی کو تیار نشان زد کرے، جب برانچ پہلی بار پش ہو تب نہیں۔ یہ قواعد چارٹ کے ساتھ شائع کریں۔

3. کام کے گھنٹے استعمال کریں، اور ٹیم کا کیلنڈر لکھیں۔ جمعے کی دیر شام کھولی گئی پل ریکویسٹ کو ہفتہ وار تعطیل کا انتظار نہیں اٹھانا چاہیے۔ مختلف ٹائم زونز میں پھیلی ٹیم کو قاعدہ چاہیے کہ کس کے گھنٹے گنے جائیں، اور اکثر دیانت دار جواب یہ ہوتا ہے کہ زونز کے پار حوالگی کی لاگت ہی دیکھنے لائق چیز ہے۔ انتخاب بتائیں اور مستحکم رکھیں۔

کام کو قابلِ جائزہ بنائیں

4. پل ریکویسٹس چھوٹی رکھیں، اور سائز کو ٹیم کی عادت سمجھیں۔ سائز کا وسطانیہ اور 85واں پرسنٹائل ٹریک کریں، اور بڑی ریکویسٹس کو انفرادی ناکامیوں کی بجائے ایک مجموعے کے طور پر دیکھیں۔ ٹیمیں عموماً پاتی ہیں کہ بڑی تبدیلیاں چند وجوہات سے آتی ہیں: کام کو کافی باریک نہ کاٹنا، ری فیکٹرنگ کو نئے رویے کے ساتھ ملانا، یا ضم کرنے میں بہت دیر کرنا۔ کام اس طرح کاٹیں کہ ہر پل ریکویسٹ ایک ہی چیز کرے، جو trunk-based development (ٹرنک پر مبنی ڈیولپمنٹ) اور بار بار ڈیپلائمنٹ کے پیچھے چھوٹے بیچ کے اصول سے بھی ملتا ہے۔

5. سائز کی سخت حد کو ہدف نہ بنائیں۔ "400 لائنوں سے زیادہ نہیں" جیسی حد تبدیلی کو مصنوعی ٹکڑوں میں توڑنے کو دعوت دیتی ہے جو انفرادی طور پر ناقابلِ فہم ہوں یا اکیلے ضم کرنے پر بلڈ توڑیں۔ سائز کو ریٹرو اسپیکٹو میں گفتگو شروع کرنے کے لیے استعمال کریں، اور ٹیم کو تقسیم کی تکنیکیں دیں، جیسے فیچر ٹوگلز، علیحدہ پل ریکویسٹ میں تیاری کی ری فیکٹرنگ، اور فلیگ کے پیچھے ضم کرنا۔

6. جائزے کی درخواست واضح کریں۔ جس پل ریکویسٹ میں کسی جائزہ لینے والے کا نام نہ ہو وہ رضاکار کا انتظار کرتی ہے، اور رضاکار کم ہیں۔ کام کرنے کے معاہدے میں اتفاق کریں کہ کس سے پوچھا جاتا ہے، ٹیم کو کیسے مطلع کیا جاتا ہے، اور جواب کی توقع کیا ہے۔ مشترکہ جائزے کا روٹا، یا روزانہ جائزے کا وقت، عموماً کسی بھی ٹول کی ترتیب سے زیادہ انتظار گھٹاتا ہے۔

بوجھ اور علم کو پھیلائیں

7. ٹیم کی سطح کے خطرے کے طور پر بوجھ کے ارتکاز پر نظر رکھیں۔ اگر دو لوگ زیادہ تر جائزے سنبھالتے ہیں تو ان کی دستیابی ٹیم کے بہاؤ کو محدود کرتی ہے، اور ان کی غیر حاضری اسے روک دیتی ہے۔ ارتکاز کی پیمائش کا ماہانہ جائزہ لیں، اور ٹیم کے ڈیزائن کے ذریعے عمل کریں: ڈیفالٹ جائزہ لینے والے کو بدلیں، نئے ارکان کو تجربہ کار کے ساتھ جوڑیں، اور کوڈ کے وہ حصے لکھ لیں جنہیں صرف ایک شخص جائزہ لے سکتا ہے۔ فی شخص لیڈر بورڈ شائع نہ کریں۔

8. جائزے سے علم بانٹیں، اور اس مقصد کی حفاظت کریں۔ جائزے کی طویل مدتی قدر میں سیکھنا، مشترکہ ملکیت اور مستقل انداز شامل ہیں، خرابی کی کھوج کے ساتھ ساتھ۔ Pair programming (جوڑی پروگرامنگ) اور مجموعی پروگرامنگ اس تبادلے کا کچھ حصہ عمل میں پہلے لے جاتے ہیں؛ جہاں جوڑی پہلے ہی کسی تبدیلی پر کام کر چکی ہو وہاں ہلکا جائزہ معقول ہے۔ انتخاب ٹیم کا فیصلہ بنائیں، کام کرنے کے معاہدے میں لکھا ہوا، تاکہ "جوڑی میں کیا گیا، اس لیے ہلکا جائزہ" مرئی قاعدہ ہو، بہانہ نہیں۔

جائزے کو خود قابو کریں

9. خودکاری کو وہ کرنے دیں جو وہ اچھا کرتی ہے۔ فارمیٹنگ، لنٹنگ اور بنیادی جانچیں پائپ لائن کی ہیں، تاکہ انسانی توجہ ڈیزائن، درستی اور خطرے پر جائے۔ Static program analysis (ساکن پروگرام تجزیہ) اور خودکار ٹیسٹ معمولی جائزے کے دوروں کی تعداد گھٹاتے ہیں۔ باقی دور پھر ڈیزائن کی گفتگو کے بارے میں زیادہ اور انداز کے اختلاف کے بارے میں کم بتاتے ہیں۔

10. جائزے کے دوروں کو وضاحت کے اشارے کے طور پر پڑھیں، خرابیوں کی گنتی کے طور پر نہیں۔ کئی دوروں کا مطلب ہو سکتا ہے کہ ضرورت غیر واضح تھی، مصنف کے پاس سیاق نہیں تھا، جائزہ لینے والے نے ذوق کی تبدیلیاں مانگیں، یا تبدیلی بڑی تھی۔ ہر پل ریکویسٹ پر صفر دور کا مطلب بہترین کام بھی ہو سکتا ہے اور یہ بھی کہ کسی نے دیکھا نہیں۔ غیر معمولی طور پر زیادہ یا کم دوروں والی چند پل ریکویسٹس کا نمونہ لیں اور انہیں ٹیم کے طور پر ساتھ پڑھیں۔

رفتار کو معیار سے جوڑیں، اور وقت مرئی رکھیں

11. جائزے کی رفتار کے ساتھ ہمیشہ معیار کا ساتھی دکھائیں۔ ضم کے بعد اصلاح کی شرح، حالیہ تبدیلیوں سے جڑے انسیڈنٹس، اور ریلیز کے بعد ملنے والی خرابیوں کا حصہ فطری ساتھی ہیں (موضوع 4.4، تبدیلی کی ناکامی اور دوبارہ کام دیکھیں)۔ اگر جائزے کا وقت بہتر ہو جبکہ اصلاح کی شرح بگڑے تو ٹیم نے یقین دہانی رفتار کے بدلے دی ہے، اور حل ہدف نہیں گفتگو ہے۔ دونوں ایک چارٹ پر دکھائیں۔

12. جائزے کو بہاؤ کی تصویر اور غیر منصوبہ بند کام سے جوڑیں۔ تیز جائزہ تب ہی مدد کرتا ہے جب اگلا مرحلہ کام کو صرف قطار میں نہ لگائے (موضوع 2.3، جاری کام اور قطار کا نظریہ دیکھیں)۔ فوری جائزے کی درخواستیں جو منصوبہ بند کام میں خلل ڈالتی ہیں اپنی لاگت رکھتی ہیں (موضوع 2.9، آپریشنل کام اور غیر منصوبہ بند کام دیکھیں)۔

بگاڑ کے راستے اور حفاظتی حدیں

میٹرک بگاڑ کیسے آتا ہے جوڑی دار حفاظتی میٹرک یا طریقہ
پہلے جائزے کا وقت پہلے جواب کے طور پر فوری "ٹھیک لگتا ہے" یا ایموجی پوسٹ کرنا؛ بوٹ یا دوستانہ جائزہ لینے والے کو تفویض کرنا؛ پل ریکویسٹ کو تب ہی تیار نشان زد کرنا جب کوئی دیکھنے پر پہلے سے رضامند ہو ضم کے بعد اصلاح کی شرح؛ بغیر تبصرے کی منظوریوں کا نمونہ؛ کام کرنے کے معاہدے میں لازمی کریں کہ پہلے جواب بامعنی ہوں
جائزے کا سائیکل ٹائم جائزے کا انتظار کیے بغیر ضم کرنا؛ تیز گزرنے کے لیے تبدیلی کو معمولی ٹکڑوں میں توڑنا؛ گھڑی دوبارہ طے کرنے کے لیے پل ریکویسٹ بند کر کے کھولنا بند اور دوبارہ کھولی گئی پل ریکویسٹس کی گنتی؛ جائزے کے دور؛ ضم کے بعد اصلاح کی شرح؛ محفوظ برانچ کے قواعد جو منظوری لازمی کریں
پل ریکویسٹ کا سائز گنتی سے فائلیں خارج کرنا؛ اکیلی تبدیلی کو ایسے ٹکڑوں میں بانٹنا جو الگ سمجھ نہ آئیں؛ پیدا شدہ کوڈ سے سائز پھلانا ہر سہ ماہی آئی گنور قواعد کا جائزہ لیں؛ جانچیں کہ تقسیم شدہ ٹکڑے اکیلے بنتے اور ٹیسٹ پاس کرتے ہیں؛ سب سے چھوٹی اور سب سے بڑی کا نمونہ پڑھیں
جائزے کے دور گنتی کم رکھنے کے لیے پہلی بار ہی منظور کرنا؛ گفتگو چیٹ میں لے جانا تاکہ اس کا کوئی نشان نہ رہے؛ مصنفین کا دور چھپانے کے لیے ایک کمٹ میں کئی اصلاحیں پش کرنا ضم کے بعد اصلاح کی شرح؛ صفر دور والی پل ریکویسٹس کا نمونہ؛ گفتگو پل ریکویسٹ ہی میں رکھیں
جائزے کے بوجھ کا ارتکاز گنتی پھیلانے کے لیے جائزوں کو بہت سی چھوٹی منظوریوں میں توڑنا؛ جائزے ان کو تفویض کرنا جن کے پاس وقت ہے مگر علم نہیں خطرناک حصوں کے لیے جائزہ لینے والے کے علم کا جائزہ لیں؛ حصے کے لحاظ سے ضم کے بعد اصلاح کی شرح دیکھیں؛ میٹرک ٹیم کی سطح پر رکھیں
پرانی پل ریکویسٹس کی گنتی پرانی پل ریکویسٹس کو ضم کیے بغیر بند کرنا؛ انہیں چھپانے کے لیے ڈرافٹس میں بدلنا؛ پرانی ہونے کی حد بڑھانا بغیر ضم بند پل ریکویسٹس کی گنتی؛ لمبے چلنے والے ڈرافٹس کی گنتی؛ ہر سہ ماہی ٹیم کے ساتھ حد کا جائزہ
ضم کے بعد اصلاح کی شرح اصلاحات کو بغیر ربط کے نئے کام کے آئٹم کے تحت درج کرنا؛ اصلاحی کام کو منصوبہ بند فالو اپ لیبل دینا؛ اصلاح کو ونڈو سے آگے ٹال کر میٹرک سے بچنا انسیڈنٹ اور تبدیلی کی ناکامی کے ڈیٹا سے موازنہ؛ فالو اپ آئٹمز کا نمونہ؛ استعمال شدہ لیبلز کا آڈٹ

صحت مند پڑھت پرسکون ہوتی ہے۔ پہلے جائزے کا وقت مختصر ہے اور دم بھی مختصر ہے، اس لیے کوئی پل ریکویسٹ دنوں انتظار نہیں کرتی۔ سائز ایسی حد میں ہے جسے ٹیم پڑھنے میں آسان پاتی ہے، چند بڑی تبدیلیوں کے ساتھ جن کی ٹیم وضاحت کر سکتی ہے۔ جائزے کے دور کم مگر صفر نہیں، بوجھ کا ارتکاز معتدل، پرانی گنتی چھوٹی، اور ضم کے بعد اصلاح کی شرح مستحکم ہے۔ جب ایک عدد تیزی سے بہتر ہو تو کوئی دیکھے کہ اس کی جوڑی دار حفاظتی حد غلط سمت میں نہیں ہلی۔

سمجھوتے: فوائد اور نقصانات

طریقہ خوبی کمزوری
جواب کی سخت توقعات کے ساتھ تیز جائزہ مختصر فیڈ بیک کے دائرے؛ مصنف کے لیے سیاق کا کم نقصان؛ کم جاری کام منظوری میں جلدی کا دباؤ؛ توجہ والے کام میں خلل
سست، مکمل جائزہ ڈیزائن اور خطرے کا محتاط مطالعہ؛ علم کی مضبوط منتقلی لمبا سائیکل ٹائم؛ بڑے بیچ جمع ہوتے ہیں؛ مصنف آگے بڑھ کر سیاق کھو دیتے ہیں
چھوٹی پل ریکویسٹس پڑھنا اور واپس کرنا آسان؛ ہموار بہاؤ فی تبدیلی زیادہ بوجھ؛ فیچر کو الجھن والے قدموں میں توڑ سکتی ہیں
بڑی پل ریکویسٹس کم حوالگیاں؛ پورا فیچر ایک بار میں نظر آتا ہے جائزے سطحی ہو جاتے ہیں؛ واپس کرنا مشکل؛ لمبے انتظار
نامزد مالک کی طرف سے لازمی منظوری خطرناک حصوں کے لیے واضح جواب دہی؛ تبدیلی کی اجازت کو سہارا رکاوٹ اور واحد نقطۂ ناکامی بناتی ہے
انسانی جائزے سے پہلے خودکار جانچیں لوگوں کو ڈیزائن اور خطرے کے لیے آزاد کرتی ہیں؛ مستقل جھوٹا اعتماد پیدا کر سکتی ہیں؛ دیکھ بھال چاہیے

کوئی ایک پالیسی نہیں جیتتی۔ مقصد باریکی برقرار رکھتے ہوئے انتظار مختصر کرنا ہے، اور عام راستہ چھوٹی تبدیلیاں، جائزے کی واضح توقعات، معمول کی جانچوں کے لیے مضبوط خودکاری، اور ٹیم کا اس پر معاہدہ ہے کہ اچھا جائزہ کیسا ہوتا ہے۔ جائزے کے میٹرکس ریٹرو اسپیکٹو کے سوالات کے طور پر سب سے زیادہ مفید ہیں اور اہداف کے طور پر سب سے کم۔

ٹیم کے ساتھ بات کرنے کے سوالات

1. پل ریکویسٹ اپنی زندگی کا زیادہ تر حصہ کہاں گزارتی ہے، انتظار میں یا جائزے میں؟ ٹیم سے ڈیٹا دیکھنے سے پہلے اندازہ لگانے کو کہیں، پھر پہلے جائزے کے وقت اور ضم تک باقی وقت کا تناسب دکھائیں۔ زیادہ تر گروپ اس بات پر حیران ہوتے ہیں کہ کتنا انتظار ہے۔ سہولت کار نوٹ کرے کہ کون سے اندازے غلط تھے اور پوچھے کہ ہر غلط اندازہ ٹیم کے جائزے کے تجربے کے بارے میں کیا کہتا ہے۔ سب سے بڑے انتظار پر حملہ کرنے والی ایک تبدیلی پر ختم کریں۔

2. اس ٹیم میں اچھا جائزہ کیسا ہوتا ہے، اور کوئی باہر والا کیسے بتائے گا؟ وہ رویے فہرست کریں جنہیں ٹیم اہمیت دیتی ہے، جیسے ڈیزائن کے بارے میں پوچھنا، ٹیسٹ جانچنا، اور درخواست کی وجہ بتانا۔ پھر پوچھیں کہ ان میں سے کون سے پل ریکویسٹ میں مرئی نشان چھوڑتے ہیں۔ بات کریں کہ افراد کی نگرانی کیے بغیر بامعنی پہلے جواب کو علامتی سے کیسے الگ کیا جائے۔ کام کرنے کے معاہدے میں رکھنے کے لیے مختصر لکھی وضاحت پر اتفاق کریں۔

3. ہمارے لیے کتنا بڑا بہت بڑا ہے، اور جب کام واقعی بڑا ہو تو ہم کیا کرتے ہیں؟ سائز کی تقسیم دیکھیں اور چند سب سے بڑی پل ریکویسٹس چنیں۔ پوچھیں کہ ہر ایک بڑی کیوں تھی اور کیا اسے کاٹا جا سکتا تھا۔ فیچر ٹوگلز، تیاری کی ری فیکٹرنگ، اور فلیگ کے پیچھے ضم جیسی تکنیکوں پر بات کریں۔ سہولت کار عددی حد طے کرنے کی مزاحمت کرے اور اس کی بجائے ایسی عادت پر اتفاق کرے جو ٹیم ایک مہینہ آزمائے۔

4. ہمارا سب سے خطرناک کوڈ کون دیکھتا ہے، اور وہ غیر حاضر ہوں تو کیا ہوتا ہے؟ کوڈ کے حصوں کا ان لوگوں سے نقشہ بنائیں جو انہیں اچھی طرح جانچ سکتے ہیں۔ بوجھ کا ارتکاز اور اکلوتے اہل جائزہ لینے والے والے حصے دیکھیں۔ بات کریں کہ جوڑی بنا کر یا تفویض کو گھما کر ہر ایک میں دوسرا جائزہ لینے والا کیسے تیار کیا جائے۔ گفتگو کو ٹیم کی مضبوطی کے بارے میں رکھیں، کسی شخص کے کام کے بوجھ کی درجہ بندی کے بارے میں نہیں۔

5. اگر کل ہماری جائزے کی رفتار دگنی ہو جائے تو ہم معیار کے بارے میں کیا سچ چاہیں گے؟ گروپ سے ان معیار کے اشاروں کے نام لینے کو کہیں جن پر وہ نظر رکھیں گے، جیسے ضم کے بعد اصلاحات، حالیہ تبدیلیوں سے جڑے انسیڈنٹس، یا ریورٹس کی تعداد۔ جانچیں کہ کیا وہ اشارے ابھی رفتار کے چارٹ کے ساتھ مرئی ہیں۔ بات کریں کہ اس کی ابتدائی علامت کیا ہوگی کہ رفتار باریکی کی قیمت پر خریدی گئی۔ ڈیش بورڈ پر کون سا ساتھی دکھانا ہے اس پر اتفاق کریں۔

6. جائزے کے کون سے اعداد کو ہم ایسے طریقے سے بہتر کرنے پر آمادہ ہو سکتے ہیں جو مدد نہ کرے؟ ہر میٹرک سے گزریں اور پوچھیں کہ دباؤ میں کوئی کچھ بھی بہتر کیے بغیر اسے بہتر کیسے دکھا سکتا ہے۔ جوابات کا اوپر کی بگاڑ کی ٹیبل سے موازنہ کریں اور ٹیم کے اپنے خیالات شامل کریں۔ مقصد خطرے کا نام ہونے سے پہلے لینا ہے۔ اتفاق کریں کہ ہر میٹرک کے ساتھ کون سی حفاظتی حد کا جائزہ ہوگا۔

چار زاویے

پروڈکٹ اور فراہمی کی ٹیمیں

فراہمی کی ٹیمیں جائزے کے عمل کی مالک ہیں اور انہیں اس کے میٹرکس کا مالک ہونا چاہیے۔ انہیں سادہ معاہدوں سے انتظار گھٹانے میں سب سے زیادہ فائدہ ہوتا ہے: روزانہ جائزے کا وقت، درخواست کا واضح عمل، اور چھوٹی تبدیلیاں۔ انہیں ریٹرو اسپیکٹو میں اعداد استعمال کرنے، جاری کام کم رکھنے، اور ایک چارٹ کو بہتر بنانے کی ترغیب کی مزاحمت کرنے چاہیے۔ جائزہ وہ جگہ بھی ہے جہاں نئے ارکان کوڈ بیس سیکھتے ہیں، اس لیے اس مقصد کی حفاظت کریں۔

سروس اور آپریشنز کی ٹیمیں

آپریشنز ٹیمیں جائزے سے وہاں ملتی ہیں جہاں انفراسٹرکچر کا کوڈ، ترتیب اور رن بک کی خودکاری پل ریکویسٹس کے ذریعے بدلی جاتی ہے۔ ان کے لیے جائزہ اکثر اس کا حصہ ہے کہ معیاری تبدیلی کیسے منظور اور ثابت ہوتی ہے (موضوع 4.3، تبدیلی کو ممکن بنانے کے میٹرکس دیکھیں)۔ انہیں اتفاق کرنا چاہیے کہ کن تبدیلیوں کو دوسرے شخص کا جائزہ چاہیے، فوری اصلاحات کا جائزہ کتنی جلدی ہو، اور ہنگامی تبدیلیوں کا بعد میں جائزہ کیسے ہو، تاکہ جلدی کی اصلاح بھی پرکھی جائے۔ خطرناک تبدیلی پر ہلکا جائزہ بعد میں انسیڈنٹ کے طور پر ظاہر ہوتا ہے۔

قیادت اور گورننس

قائدین کو جائزے کے میٹرکس کو ٹیم کی صحت اور بہاؤ کے اشارے سمجھنا چاہیے، پیداواریت کے اسکور نہیں۔ جب رفتار کا عدد رپورٹ ہو تو انہیں جوڑی دار معیار کی پیمائش مانگنی چاہیے، محتاط جائزے کو لگنے والے وقت کو سہارا دینا چاہیے، اور خام جائزے کے وقت پر ٹیموں کا موازنہ کرنے سے بچنا چاہیے، کیونکہ ریپوزٹریز اور خطرات مختلف ہیں۔ گورننس کے ادارے جائزے کے شواہد کو تبدیلی کی یقین دہانی کا حصہ بنا سکتے ہیں، بشرطیکہ وہ مانیں کہ دستاویزی، نمونہ شدہ جائزے کا عمل منظوریوں کی گنتی سے مضبوط ہے۔

صارفین اور استعمال کنندگان

گاہک پل ریکویسٹس نہیں دیکھتے، پھر بھی نتائج محسوس کرتے ہیں: اصلاح کتنی جلدی پہنچتی ہے اور ریلیز کتنی بار نئی خرابی لاتی ہے۔ جائزے کا مختصر انتظار فوری اصلاحات کو ان تک جلد پہنچنے میں مدد دیتا ہے، اور محتاط جائزہ خرابیوں کو ان سے دور رکھنے میں۔ جہاں سروس کی شائع شدہ ریلیز یا خرابی کی تاریخ ہو وہاں گاہکوں کو فائدہ ہوتا ہے جب ٹیم وقت کے ساتھ کم ریورٹس اور کم بار بار کی اصلاحات دکھائے۔

عملی مثال: خدمات کے انتظام کی ایک مثال

ایک علاقائی اسپتال کا آئی ٹی شعبہ مریضوں کی اپائنٹمنٹ کی ویب سروس چلاتا ہے، جو سات رکنی پروڈکٹ ٹیم نے بنائی اور چھوٹے سائٹ ریلائبلٹی گروپ کے ساتھ چلائی جاتی ہے۔ اس مثال کے تمام اعداد مثال کے لیے ہیں۔

سہ ماہی جائزے میں ٹیم پاتی ہے کہ اس کے جائزے کے سائیکل ٹائم کا وسطانیہ 26 کام کے گھنٹے اور 85واں پرسنٹائل 71 کام کے گھنٹے ہے (مثال کے لیے)۔ دائرہ بانٹنے سے پتا چلتا ہے کہ پہلے جائزے کا وسطانی وقت 19 کام کے گھنٹے ہے، اس لیے زیادہ تر تاخیر انتظار ہے۔ پل ریکویسٹ کے سائز کا وسطانیہ 180 لائنیں اور 85واں پرسنٹائل 900 لائنیں ہے (مثال کے لیے)، اور دو مصروف ترین جائزہ لینے والے 68 فیصد جائزے سنبھالتے ہیں (مثال کے لیے)۔ ضم کے بعد اصلاح کی شرح 9 فیصد پر ہے (مثال کے لیے)۔

ٹیم تین معاہدے کرتی ہے۔ وہ روزانہ 30 منٹ کا جائزے کا وقت مقرر کرتے ہیں، ایک کام کے دن کے اندر پہلے جواب کی توقع اپنے کام کرنے کے معاہدے میں لکھتے ہیں، اور ہر ہفتے "پہلے جائزہ" کی ڈیوٹی گھماتے ہیں۔ وہ بڑے کام کے لیے تقسیم کی عادت بھی اپناتے ہیں، فیچر ٹوگلز استعمال کرتے ہوئے تاکہ جزوی فیچرز محفوظ طریقے سے ضم ہو سکیں۔ وہ سائز کی حد یا پہلے جائزے کے وقت کا ہدف نہیں رکھتے۔

دو مہینے بعد پہلے جائزے کا وسطانی وقت 6 کام کے گھنٹے اور جائزے کے سائیکل ٹائم کا 85واں پرسنٹائل 34 کام کے گھنٹے رہ جاتا ہے (مثال کے لیے)۔ بوجھ کا ارتکاز 52 فیصد پر گرتا ہے (مثال کے لیے)، اور ضم کے بعد اصلاح کی شرح 9 فیصد پر برقرار رہتی ہے۔

پھر ٹیم بگاڑ کا خطرہ پکڑتی ہے۔ منظوریوں کا نمونہ دکھاتا ہے کہ تقریباً ایک تہائی پہلے جوابات منٹوں میں آتے ہیں اور اپائنٹمنٹ یاد دہانی کی منطق کو چھونے والی تبدیلیوں پر صرف "LGTM" پڑھتے ہیں۔ رفتار کا فائدہ جزوی طور پر حقیقی اور جزوی طور پر ربر اسٹیمپ تھا۔ ضم کے بعد اصلاح کی شرح ابھی نہیں ہلی تھی کیونکہ متاثرہ کوڈ ماہانہ دور پر چلتا ہے۔ ٹیم کام کرنے کے معاہدے کو بدلتی ہے تاکہ پہلے جواب میں یا سوال ہو، یا تبدیلی کے کسی مخصوص حصے پر تبصرہ، یا اس کا صریح نوٹ کہ کیا جانچا گیا، اور اپنے جائزے کے چارٹ میں بغیر تبصرے کی منظوریوں کا نمونہ شدہ حصہ شامل کرتی ہے۔ وہ یہ بھی اتفاق کرتے ہیں کہ مریضوں کو نظر آنے والی یاد دہانی کی منطق کی تبدیلیوں کو دو جائزہ لینے والے چاہییں، جن میں سے ایک آپریشنز گروپ سے ہو۔ وجوہات کے ساتھ فیصلہ ٹیم کے فیصلوں کے لاگ میں جاتا ہے۔

ایجائل، مصنوعی ذہانت، خودکاری اور تجزیات

ایجائل

تیز، چھوٹے جائزے مسلسل فراہمی اور پائیدار رفتار کو سہارا دیتے ہیں۔ عملی عادت پہلے جائزے کے وقت پر ٹیم کا معمول طے کرنا اور باقاعدہ ٹیم جائزے میں پرانی پل ریکویسٹس پر بات کرنا ہے۔ احتیاط یہ ہے کہ جائزے کی رفتار کو ہدف بنانا ربر اسٹیمپنگ کی طرف لے جاتا ہے، اس لیے اسے ضم کے بعد اصلاحات سے جوڑیں۔

اے آئی

اے آئی کی بنائی تبدیلیاں پل ریکویسٹ کا حجم اور سائز بڑھا سکتی ہیں، اور اے آئی جائزے کے ٹولز پہلی نظر تیز کر سکتے ہیں۔ پہلے جائزے کے وقت کو اے آئی کی مدد والی تبدیلیوں کے لیے ضم کے بعد اصلاح کی شرح سے جوڑیں، اور جائزے کا بوجھ فی شخص نہیں بلکہ جائزہ لینے والے کے کردار کے لحاظ سے رپورٹ کریں۔ احتیاط یہ ہے کہ بوٹ کا جائزے کا تبصرہ جائزہ گنا جا سکتا ہے، اس لیے انسانی جائزہ الگ گنیں۔

خودکاری

جائزے کے ایونٹس کوڈ ہوسٹ سے خودکار طور پر لیں، اور انسانی جائزے سے پہلے خودکار جانچیں چلائیں تاکہ لوگ فیصلے پر وقت لگائیں۔ جانچوں کو خود جھوٹے الارم اور اس خرابیوں پر ناپیں جو ان سے بچ نکلتی ہیں۔ احتیاط یہ ہے کہ بھاری خودکاری انسانی جائزے کو سطحی بنا سکتی ہے، کیونکہ لوگ فرض کرتے ہیں کہ ٹولز نے سب پکڑ لیا۔

تجزیات

ٹیم کے لحاظ سے سائز، پہلے جائزے کے وقت اور جائزے کے دوروں کی تقسیم دکھائیں، فرد کے لحاظ سے کبھی نہیں۔ جو فیصلہ یہ آگاہ کرتا ہے وہ یہ ہے کہ جائزے کی صلاحیت یا تبدیلی کے سائز پر توجہ کہاں چاہیے۔ احتیاط یہ ہے کہ یہ اعداد جائزے کے نظام کو بیان کرتے ہیں، اور لوگوں کی درجہ بندی کرنے والا کوئی بھی استعمال انہیں چھوٹی، محفوظ، کم مفید تبدیلیوں کی طرف دھکیلے گا۔

شعبہ جاتی نقطۂ نظر

اسٹارٹ اپ۔ چھوٹی ٹیم منٹوں میں جائزہ لے سکتی ہے کیونکہ ہر کوئی کوڈ جانتا ہے، اور بنیادی خطرہ وقت کم ہونے پر جائزہ چھوڑنا ہے۔ میٹرکس کم رکھیں: پہلے جائزے کا وقت اور سائز کافی ہیں۔ چھوٹی تبدیلیوں کی عادت جلد قائم کریں، کیونکہ کوڈ بیس اور ٹیم کے بڑھنے کے بعد اسے متعارف کرانا بہت مشکل ہے۔

چھوٹا کاروبار۔ اکثر ایک یا دو ڈیولپر، یا بیرونی سپلائر، سافٹ ویئر سنبھالتے ہیں۔ جائزہ کسی ایک ساتھی یا سپلائر کا اپنا عملہ لے سکتا ہے۔ سپلائرز سے پوچھیں کہ وہ جائزہ کیسے لیتے ہیں اور کیا پل ریکویسٹ کا ڈیٹا شیئر ہو سکتا ہے، اور سادہ ریکارڈ رکھیں کہ کن تبدیلیوں کا جائزہ کس نے لیا، کیونکہ چھوٹی ٹیم میں غلطیوں کے خلاف جائزہ اصل جانچ ہے۔

بڑا ادارہ۔ بہت سی ٹیمیں، ریپوزٹریز اور منظوری کے قواعد وسیع تغیر پیدا کرتے ہیں۔ گھڑیوں اور اخراج کی تعریفیں معیاری کریں تاکہ پلیٹ فارم کا ڈیٹا قابلِ موازنہ ہو، لیکن خام جائزے کے وقت پر ٹیموں کی درجہ بندی نہ کریں، کیونکہ خطرہ اور کوڈ بیس مختلف ہیں۔ آڈٹ کے لیے مسلط جائزے کی ایسی شرائط پر نظر رکھیں جو باریکی کے بغیر انتظار بڑھاتی ہیں، اور دستی منظوریوں کو خودکار جانچوں اور نمونہ شدہ جائزے سے بدلنے کے مواقع تلاش کریں۔

حکومت اور عوامی شعبہ۔ فرائض کی علیحدگی، آڈٹ ٹریلز اور خریداری کے قواعد اکثر تبدیلیوں کے لیے آزاد منظوری مانگتے ہیں۔ انہیں ڈیزائن کے ان پٹ سمجھیں: درج کریں کہ کس نے کیا اور کب منظور کیا، اور وہ انتظار ناپیں جو وہ پیدا کرتے ہیں۔ جہاں سپلائرز کوڈ لکھتے ہیں وہاں معاہدے میں جائزے کے شواہد اور ڈیٹا تک رسائی بیان کریں (موضوع 8.5، ضابطے کی اور سرکاری رپورٹنگ دیکھیں)۔

کاروباری جواز: محرکات، ROI اور TCO

محرک فراہمی کا وہ حصہ مختصر کرنا ہے جو سست بھی ہے اور قابو میں بھی، جبکہ ساتھی جائزے کے فوائد برقرار رکھنا: کم خرابیاں، مشترکہ علم، اور آڈٹ ٹریل۔ انتظار کرتی پل ریکویسٹس مکمل کام کو صارفین سے روکتی ہیں، مصنفین کے لیے سیاق بدلنے کی لاگت بڑھاتی ہیں، اور برانچز پرانی ہونے کے ساتھ ضم کے تنازعات کا امکان بڑھاتی ہیں۔ انتظار گھٹانا اس لیے تیز تر فراہمی، کم دوبارہ کام، اور کم مایوسی سے ادا کرتا ہے۔

ان میٹرکس کو جمع کرنے کی لاگت اس وقت کم ہے جب ورژن کنٹرول پلیٹ فارم ایونٹ ہسٹری اور API فراہم کرے۔ بنیادی لاگتیں گھڑیاں اور اخراج متعین کرنے، رپورٹ بنانے یا ترتیب دینے، اور اعداد کا باقاعدہ جائزہ لینے کا وقت ہیں۔ بڑی لاگت رویے کی ہے: لوگوں کا فوری جائزے کو دیا ہوا وقت، جو دوسرے کام سے مقابلہ کرتا ہے۔ وہ وقت اصل سرمایہ کاری ہے، اور اسے مفت سمجھنے کی بجائے بجٹ میں رکھنا چاہیے۔

منافع جائزے کے مختصر سائیکل ٹائم، کم پرانی پل ریکویسٹس، اور مستحکم یا گھٹتی ضم کے بعد اصلاح کی شرح کی شکل میں ظاہر ہوتا ہے۔ پیشگی کسی خاص فیصد بہتری کا دعویٰ نہ کریں، کیونکہ نتائج نقطۂ آغاز اور ٹیم پر منحصر ہیں۔ قابلِ یقین جواز دوسری تنظیموں کے اعداد نقل کرنے کی بجائے ٹیم کی اپنی پہلے اور بعد کی تقسیم کا اس کے معیار کے ساتھی کے ساتھ موازنہ کرتا ہے۔ 2018 کی کتاب Accelerate تکنیکی اور ثقافتی طریقوں کو فراہمی کی کارکردگی سے جوڑنے والی تحقیق رپورٹ کرتی ہے اور عمومی دلیل کے لیے معقول ماخذ ہے، لیکن آپ کی ٹیم کے اعداد آپ کے اپنے ڈیٹا سے آتے ہیں۔

غلط طریقے اور خطرات

  • جائزہ لینے والوں یا مصنفین کی درجہ بندی۔ مکمل کیے گئے جائزوں یا بدلی گئی لائنوں کے انفرادی لیڈر بورڈ تعاون کو بگاڑتے ہیں۔ ٹیم کی سطح پر رپورٹ کریں اور اعداد ٹیم کی عادتیں ایڈجسٹ کرنے کے لیے استعمال کریں۔
  • معیار کے ساتھی کے بغیر پہلے جائزے کے وقت کا ہدف۔ نتیجہ ربر اسٹیمپ ہے۔ ہر رفتار کے چارٹ کے ساتھ ضم کے بعد اصلاح کی شرح اور بغیر تبصرے کی منظوریوں کا نمونہ دکھائیں۔
  • سائز کی سخت حد رکھنا۔ ٹیمیں تعمیل کے لیے کام مصنوعی طور پر بانٹتی ہیں۔ سائز کو گفتگو کے لیے استعمال کریں اور اس کی بجائے کاٹنے کی تکنیکیں سکھائیں۔
  • صفر تبصروں کو کامیابی سمجھنا۔ بغیر جانچ کی منظوری اعتماد یا غفلت کی عکاس ہو سکتی ہے۔ ایسی پل ریکویسٹس کا نمونہ لیں اور انہیں مل کر پڑھیں۔
  • بوٹ کی سرگرمی کو جائزہ گننا۔ خودکار تبصرے انتظار کو مختصر دکھاتے ہیں۔ بوٹس کو گھڑی اور بوجھ کی پیمائشوں دونوں سے خارج کریں۔
  • ٹائم زونز اور کیلنڈر کو نظر انداز کرنا۔ خام گھڑی کا وقت ہفتہ وار تعطیل اور خطوں کے پار انتظار کو سست جائزہ دکھاتا ہے۔ کام کے گھنٹے استعمال کریں اور کیلنڈر کا نام لیں۔
  • پرانی فہرست کو بڑھنے دینا۔ پرانی پل ریکویسٹس ضم کے تنازعات جمع کرتی اور سیاق کھوتی ہیں۔ فہرست کا ہر ہفتے جائزہ لیں اور ہر آئٹم کو ضم کریں، دوبارہ کام کریں یا وجہ کے ساتھ بند کریں۔

پختگی کا ماڈل

پہلو 1 آغاز 2 ترقی 3 معیار بندی 4 انتظام 5 ہم آہنگی
تعریف اور گھڑیاں جائزے کا وقت اندازے سے یا احساس سے بتایا جاتا ہے کچھ ٹیمیں اپنے قواعد سے پلیٹ فارم سے اوقات برآمد کرتی ہیں ہر گھڑی کی ایک لکھی تعریف، بوٹس، ڈرافٹس اور کیلنڈر کے اخراج کے ساتھ تعریفوں کا رفتار پر جائزہ؛ تبدیلیاں وجوہات کے ساتھ لاگ تعریفیں ٹیموں اور سپلائرز میں ہم آہنگ اور فیصلوں کو آگاہ کرنا چھوڑیں تو نظرِ ثانی
جائزے کا عمل جائزے تب ہوتے ہیں جب کوئی نوٹس کرے کچھ ٹیموں میں غیر رسمی معمولات درخواستوں، جواب کی توقعات اور جائزے کے احاطے پر لکھا کام کرنے کا معاہدہ ڈیٹا سے معمولات ایڈجسٹ؛ علم کا اشتراک اور خطرے کے حصے ٹریک جائزے کا عمل ٹیموں اور سپلائرز میں ہم آہنگ، معمول کی جانچیں خودکاری کے ہاتھ میں
معیار کا ساتھی جائزے اور خرابیوں کے درمیان کوئی ربط نہیں ضم کے بعد اصلاحات پر کبھی کبھار نظر ضم کے بعد اصلاح کی شرح جائزے کی رفتار کے ساتھ دکھائی گئی حفاظتی حدوں کا باقاعدہ جائزہ؛ نمونہ شدہ منظوریاں پڑھی جاتی ہیں جائزے کے شواہد سروسز میں تبدیلی کی یقین دہانی اور انسیڈنٹ سے سیکھنے سے جڑے
بہتری میں استعمال اعداد غیر استعمال شدہ کچھ ریٹرو اسپیکٹو میں دکھائے جاتے ہیں مالک ٹیم مقررہ رفتار پر جائزہ لیتی ہے خلا منصوبہ بند، وسائل والے بہتری کے کام کی طرف لے جاتے ہیں بہتری کے خیالات ٹیموں سے مشترکہ عمل تک اور واپس بہتے ہیں

جانچ فہرست

  • پہلے جائزے کے وقت اور جائزے کے سائیکل ٹائم کی گھڑیاں آغاز، اختتام اور اخراج کے ساتھ لکھی ہیں۔
  • بوٹس، ڈرافٹس اور بغیر ضم بند پل ریکویسٹس خارج ہیں یا الگ گنی جاتی ہیں، اور قواعد مرئی ہیں۔
  • اوقات کام کے گھنٹوں میں وسطانیے اور اونچے پرسنٹائل کے طور پر رپورٹ ہوتے ہیں۔
  • پل ریکویسٹ کا سائز پیدا شدہ اور وینڈرڈ فائلوں کی طے شدہ آئی گنور فہرست کے ساتھ ناپا جاتا ہے۔
  • ٹیم کا لکھا معاہدہ ہے کہ جائزے کی درخواست کیسے کی جاتی ہے اور پہلے جواب کی توقع کتنی جلدی ہے۔
  • جائزے کے بوجھ کا ارتکاز صرف ٹیم کی سطح پر رپورٹ ہوتا ہے۔
  • ضم کے بعد اصلاح کی شرح یا معیار کا دوسرا ساتھی جائزے کی رفتار کے ساتھ ایک ہی چارٹ پر دکھایا جاتا ہے۔
  • ہر مہینے بغیر تبصرے اور بہت تیز منظوریوں کا نمونہ پڑھا جاتا ہے۔
  • پرانی پل ریکویسٹس کی فہرست کا ہر ہفتے جائزہ ہوتا ہے۔
  • جائزے کا ڈیٹا ریٹرو اسپیکٹو میں استعمال ہوتا ہے، انفرادی تشخیص میں نہیں۔
  • کوڈ کے وہ حصے جن کا ایک ہی اہل جائزہ لینے والا ہے فہرست ہیں اور ان کا منصوبہ ہے۔

اے آئی پرامپٹس

جائزے کے میٹرکس کے لیے گھڑی کی تعریفوں کا مسودہ بنائیں۔

میں [ٹیم یا ریپوزٹری] کے لیے جائزے کے میٹرکس متعین کرنا چاہتا/چاہتی ہوں۔ ہمارا پلیٹ
فارم [ورژن کنٹرول پلیٹ فارم] ہے اور ہمارا ورک فلو [بیان کریں: ڈرافٹ پل ریکویسٹس،
لازمی منظوریاں، ضم کے قواعد، استعمال میں بوٹس] ہے۔ پہلے جائزے کے وقت اور جائزے کے
سائیکل ٹائم کی درست تعریفیں تیار کریں، یہ بتاتے ہوئے کہ ہر گھڑی کو کون سا ایونٹ شروع
اور روکتا ہے، کیا خارج ہے (بوٹس، ڈرافٹس، بغیر ضم بند)، [ٹائم زونز اور کام کا کیلنڈر] کے
لیے کام کے گھنٹے کیسے سنبھالے جاتے ہیں، اور کون سے پرسنٹائل رپورٹ کرنے ہیں۔ بینچ
مارک قدریں یا ٹول کی خصوصیات نہ گھڑیں۔ اپنے مفروضے اور وہ سوالات درج کریں جن کا جواب
مجھے تعریفیں مکمل کرنے کے لیے دینا چاہیے۔

جائزے کے ڈیٹا کی برآمدگی کا تجزیہ کریں۔

یہ [مدت] کے لیے [ٹیم] کی ضم شدہ پل ریکویسٹس کی گمنام برآمدگی ہے، کالموں [کالم
فہرست کریں، مثلاً تیار ہونے کا وقت، پہلے جائزے کا وقت، ضم کا وقت، بدلی گئی لائنیں،
جائزے کے دور، جڑی اصلاح کا نشان] کے ساتھ: [ڈیٹا یا خلاصہ چسپاں کریں]۔ ہر وقتی پیمائش
اور سائز کے لیے وسطانیہ اور 85واں پرسنٹائل نکالیں، جائزے کے دائرے کو انتظار اور جائزے
میں بانٹیں، اور وہ نمونے بتائیں جو گفتگو کے مستحق ہیں۔ افراد کی درجہ بندی نہ کریں اور بیرونی
بینچ مارکس سے موازنہ نہ کریں۔ اپنے مفروضے اور ڈیٹا کے معیار کے کسی بھی مسئلے کا ذکر
کریں۔

ہمارے جائزے کے میٹرکس میں بگاڑ کے خطرات تلاش کریں۔

ہماری ٹیم یہ جائزے کے میٹرکس رپورٹ کرتی ہے: [میٹرکس اور ہر ایک کا حساب فہرست
کریں]۔ ہم پر دباؤ [مثلاً ریلیز کی ڈیڈ لائن، قیادت کا ہدف، سپلائر کا معاہدہ] ہیں۔ ہر میٹرک
کے لیے وہ قابلِ قبول طریقے بیان کریں جن سے وہ جائزہ بہتر کیے بغیر بہتر ہو سکتا ہے، ہر ایک
کی ابتدائی علامات، اور اسے پکڑنے والی جوڑی دار حفاظتی میٹرک یا طریقہ۔ شماریات نہ
گھڑیں۔ اپنے مفروضے درج کریں اور بتائیں کہ خطرات کی درجہ بندی کے لیے مجھے کیا
جاننا چاہیے۔

جائزے کے بہاؤ پر ریٹرو اسپیکٹو کی تیاری کریں۔

[ٹیم] کے لیے جائزے کے بہاؤ پر 45 منٹ کے ریٹرو اسپیکٹو کا ایجنڈا تیار کریں۔ ان پٹ: پہلے
جائزے کا وقت [قدر]، جائزے کا سائیکل ٹائم [قدر]، سائز کا وسطانیہ [قدر]، بوجھ کا ارتکاز
[قدر]، اور ضم کے بعد اصلاح کی شرح [قدر]، سب اپنی تعریفوں کے ساتھ لیبل شدہ۔ ایسے
سوالات تجویز کریں جو وجوہات سامنے لائیں، ایک چھوٹا تجربہ جو ٹیم [مدت] کے لیے چلا سکے،
اور تجربے کے دوران نظر رکھنے کے لیے معیار کا اشارہ۔ وجوہات یا اہداف نہ گھڑیں۔ اپنے
مفروضے اور وہ ڈیٹا درج کریں جو مجھے لانا چاہیے۔

اے آئی اسکلز

  • Service Management Metrics skill: متعلقہ بہاؤ یا معیار کا میٹرک متعین کرنے والا موضوع اور جائزے کے میٹرک کے ساتھ رکھی جانے والی حفاظتی حد تلاش کرنے کے لیے استعمال کریں۔
  • Service Management Metrics maintainer skill: جانچنے کے لیے استعمال کریں کہ اس موضوع میں ترامیم ٹیمپلیٹ، بگاڑ کی ٹیبل اور باہمی حوالے ہم آہنگ رکھتی ہیں۔

اہم نکات

  • جائزے کی زیادہ تر تاخیر انتظار ہے، اس لیے پہلے جائزے کے وقت اور جائزے کے سائیکل ٹائم کو کام کے گھنٹوں میں تقسیم کے طور پر ناپیں۔
  • چھوٹی پل ریکویسٹس کا جائزہ تیز اور زیادہ احتیاط سے ہوتا ہے؛ سائز کی حد مسلط کرنے کی بجائے کاٹنا سکھائیں۔
  • ہر رفتار کی پیمائش کو معیار کے ساتھی سے جوڑیں، جیسے ضم کے بعد اصلاح کی شرح، اور دونوں کو ساتھ پڑھیں۔
  • جائزے کے بوجھ کو ٹیم کی صلاحیت سمجھیں اور ارتکاز ٹیم کی سطح پر رپورٹ کریں، لوگوں کی درجہ بندی کے طور پر کبھی نہیں۔
  • جائزے کے میٹرکس ریٹرو اسپیکٹو کے سوالات ہیں، اور وہ اس ٹیم کی خدمت کرتے ہیں جو کام کی مالک ہے۔

حوالہ جات اور مزید مطالعہ

  1. Forsgren, N., Humble, J., and Kim, G., Accelerate: The Science of Lean Software and DevOps, IT Revolution, 2018.
  2. Forsgren, N., Storey, M.-A., Maddila, C., Zimmermann, T., Houck, B., and Butler, J., "The SPACE of Developer Productivity," ACM Queue, 2021.
  3. Google, Code Review Developer Guide, Google Engineering Practices documentation, https://google.github.io/eng-practices/review/
  4. Bacchelli, A., and Bird, C., "Expectations, Outcomes, and Challenges of Modern Code Review," Proceedings of the 35th International Conference on Software Engineering (ICSE), 2013.
  5. Vacanti, D. S., Actionable Agile Metrics for Predictability: An Introduction, Daniel S. Vacanti, Inc., 2015.
  6. Schwaber, K., and Sutherland, J., The Scrum Guide, Scrum.org and Scrum Inc., 2020.
  7. Goodhart, C. A. E., "Problems of Monetary Management: The U.K. Experience," in Papers in Monetary Economics, Reserve Bank of Australia, 1975.
  8. Wikipedia, Pull request.
  9. Wikipedia, Version control.
  10. Wikipedia, Code review.
  11. Wikipedia, Goodhart's law.
  12. Wikipedia, Continuous integration.
  13. Wikipedia, Trunk-based development.
  14. Wikipedia, Pair programming.
  15. Wikipedia, Static program analysis.