مقاييس طلبات الدمج ومراجعة الشيفرة
المراجعة هي المكان الذي ينتظر فيه العمل المنتهي في أغلب الأحيان، فقِس كم يجلس التغيير قبل أن ينظر فيه أحد، وما حجمه، وكم مرة يعود، واقرن كل رقم سرعة بإشارة جودة حتى لا يعني الأسرع تهاونًا.
الملخص والدافع
طلب الدمج (pull request) هو اقتراح بدمج مجموعة تغييرات من فرع في مستودع تحكم في الإصدارات إلى فرع آخر، مع الحوار عن هل ينبغي دمجها. وهو في فرق كثيرة البوابة الرسمية بين "يرى المؤلف أنه يعمل" و"يتفق الفريق على أنه يمكن شحنه". والحوار شكل من مراجعة الشيفرة: يقرأ شخص غير المؤلف التغيير، ويطرح أسئلة، ويوافق عليه أو يطلب تعديلات. وتسمي بعض المنصات الشيء نفسه طلب دمج (merge request)؛ ويستخدم هذا الموضوع "طلب الدمج" للاثنين.
والمراجعة تستحق القياس لسبب بسيط. ففي منظور التدفق للتسليم يقضي عنصر العمل معظم حياته منتظرًا، والمراجعة إحدى فترات الانتظار التي تقع كليًا داخل سيطرة الفريق. فعنق زجاجة في منصة مشتركة أو اعتماد خارجي يحتاج إلى أن يتغير أشخاص آخرون. وطلب دمج ينتظر نظرة أولى يومين لا يحتاج إلا إلى تغيير عادات الفريق نفسه. وتعطي قياسات التدفق في هذا الكتاب (انظر الموضوع 2.1، مقاييس التدفق، والموضوع 2.2، زمن الانتظار وزمن الدورة وكفاءة التدفق) المفردات العامة. ويقرّب هذا الموضوع على مرحلة واحدة من الدورة ويعطيها أدواتها الخاصة.
وتلتقي رؤيتا أجايل وITIL هنا بطريقة مفيدة. من منظور أجايل المراجعة حلقة تغذية راجعة وآلية تعليم. فهي تنشر معرفة الشيفرة، وتلتقط العيوب مبكرًا، وتنفذ اتفاقيات عمل الفريق وتعريف الإنجاز. ومن منظور ITIL يدعم النشاط نفسه عدة ممارسات. ففي ITIL 4 تغطي ممارسة تطوير البرمجيات وإدارتها كيف تُبنى البرمجيات وتُفحص، ويغطي تمكين التغيير كيف تُقيَّم التغييرات وتُصرَّح، وتغطي إدارة النشر كيف تصل التغييرات إلى البيئة الحية. وطلب الدمج الذي راجعه الأقران هو، لمنظمات كثيرة، الدليل على أن تغييرًا قياسيًا قُيِّم قبل الإصدار. وعدّ المراجعة نشاطًا مقيسًا قابلًا للتحسين يخدم الرؤيتين: فريق أجايل يريد تغذية راجعة أسرع، وممارسة ITIL تريد ضمانًا موثوقًا بأن التغييرات فُحصت.
والخطر الذي ينبغي إبقاؤه في الأفق طوال الوقت أن سرعة المراجعة وجودتها يسهل فصلهما. فقد يخفض الفريق زمنه إلى أول مراجعة إلى النصف بالموافقة على كل شيء من النظرة الأولى، وستُظهر اللوحة انتصارًا بينما تسوء الشيفرة. وقانون غودهارت ينطبق بقوة غير عادية على هذه العائلة من المقاييس (انظر الموضوع 1.2، قانون غودهارت وعلم نفس المقاييس)، لأن الأرقام رخيصة الجمع ومرئية للجميع وسهلة التحريك جدًا دون تغيير ما أُريد لها أن تمثله. وكل توصية أدناه مكتوبة بوضع ذلك في الاعتبار.
المؤلف (author) فتح طلب الدمج والمراجع (reviewer) يقيّمه. وجولة المراجعة (review round) حلقة واحدة من "يدفع المؤلف، ويستجيب المراجع". وإعادة العمل (rework) تغيير يُجرى بعد تعليق مراجعة، أو بعد الدمج، لإصلاح شيء أخطأ فيه الإصدار الأول. والتكامل المستمر (CI) هو ممارسة دمج العمل في خط مشترك كثيرًا وفحص كل دمج آليًا؛ انظر التكامل المستمر.
كل المقاييس في هذا الموضوع تصف الفرق والمستودعات. ولا ترتب المراجعين أو المؤلفين أبدًا. فأعداد المراجعة على مستوى الأفراد سهلة الاستخراج ومغرية الاستخدام، واستخدامها يحول ممارسة تعاون إلى مسابقة (انظر الموضوع 9.1، صحة الفريق وتجربة المطوّرين).
المبادئ الأساسية
- الانتظار يهيمن على المراجعة. في معظم الفرق أكبر جزء من زمن المراجعة هو جلوس طلب الدمج غير مقروء، لا النقاش بعد أن يبدأ المراجع. قِس الانتظار قبل أن تقيس الحوار.
- التغييرات الصغيرة تُراجع أسرع وأفضل. الحجم من الروافع القليلة التي تحسن السرعة والدقة معًا، لأن المراجع يستطيع حمل تغيير صغير في ذهنه.
- السرعة بلا تدقيق ليست تحسنًا. يحتاج كل قياس سرعة في هذا الموضوع نظيرًا للجودة، ويُقرأ الزوج معًا.
- المراجعة سعة فريق لا سعة شخصية. ينبغي أن ينتشر الحمل في الفريق. والقياس الذي يُظهر تركزًا يشير إلى مشكلة تصميم في الفريق، لا إلى شخص يُمتدح أو يُلام.
- التوزيعات تفوق المتوسطات. لأزمنة المراجعة ذيل طويل من طلبات الدمج العالقة، فأبلغ بالوسيط ومئين عالٍ (انظر الموضوع 1.6، الإلمام الإحصائي لمقاييس الخدمة).
- عرّف الساعة ثم اتركها. بيّن متى تبدأ الساعة وتتوقف، وأي الأحداث توقفها، وأي النشاط الآلي مستبعد، واكتب ذلك حيث تعيش البيانات (انظر الموضوع 1.5، مصادر البيانات والأجهزة القياسية).
- قياسات المراجعة تخدم الفريق الذي يملك العمل. هي مدخل لاستعادة الفريق الرجعية، لا بطاقة درجات لأحد غيره.
تعريفات المقاييس
تفترض الساعات أدناه أن منصة التحكم في الإصدارات تسجل أوقات أحداث الفتح وطلبات المراجعة والتعليقات والموافقات والدفعات والدمج. وتُستبعد المسودات وطلبات الدمج التي تفتحها الروبوتات وطلبات الدمج المغلقة دون دمج ما لم يقل صف خلاف ذلك. و"ساعات العمل" تعني ساعات عمل الفريق المعلنة، فلا يراكم طلب دمج فُتح مساء الجمعة عطلة نهاية أسبوع من الانتظار.
| المقياس | التعريف | الصيغة | الوحدة | مصدر البيانات | ممارسة ITIL | المقابل في أجايل | التكرار |
|---|---|---|---|---|---|---|---|
| الزمن إلى أول مراجعة | الانتظار بين صيرورة طلب دمج جاهزًا للمراجعة وأول استجابة بشرية جوهرية | تبدأ الساعة حين يغادر طلب الدمج حالة المسودة أو يُفتح جاهزًا، وتتوقف عند أول تعليق مراجعة أو طلب تغيير أو موافقة من غير المؤلف؛ تُستبعد تعليقات الروبوتات والمؤلف وتغييرات الوسوم المجردة. يُبلَّغ بالوسيط والمئين 85 بساعات العمل | ساعات عمل | سجل أحداث منصة التحكم في الإصدارات | تطوير البرمجيات وإدارتها؛ تمكين التغيير | اتفاقية العمل على استجابة المراجعة؛ تدفق العمل قيد التنفيذ | أسبوعي |
| زمن دورة المراجعة | الزمن الكلي من الجاهزية للمراجعة إلى الدمج | تبدأ الساعة حين يكون طلب الدمج جاهزًا للمراجعة وتتوقف عند الدمج؛ تُستبعد طلبات الدمج المغلقة دون دمج وتُحتسب منفصلة. يُبلَّغ بالوسيط والمئين 85 بساعات العمل | ساعات عمل | سجل أحداث منصة التحكم في الإصدارات | إدارة النشر؛ تمكين التغيير | زمن دورة مرحلة المراجعة على لوحة الفريق | أسبوعي |
| حجم طلب الدمج | مقدار التغيير في طلب دمج | الأسطر المضافة زائد الأسطر المحذوفة، باستثناء الملفات المولَّدة وملفات القفل والشيفرة المضمَّنة وإعادة التسمية المجردة، كما في قواعد التجاهل في المستودع. يُبلَّغ بالوسيط والمئين 85 لكل طلب دمج مدموج | أسطر متغيرة | إحصاءات الفروق في منصة التحكم في الإصدارات | تطوير البرمجيات وإدارتها | حجم الدفعة الصغير؛ تقطيع القصص | أسبوعي |
| جولات المراجعة | عدد حلقات دفع المؤلف واستجابة المراجع قبل الدمج | عدد دورات "طُلبت تغييرات" أو تعليق ثم دفع لكل طلب دمج مدموج؛ التقديم الأول هو الجولة صفر وتُستبعد إخفاقات الفحص الآلي. يُبلَّغ بالوسيط والمئين 85 | عدد | أحداث المراجعة والدفع في منصة التحكم في الإصدارات | التحسين المستمر؛ تطوير البرمجيات وإدارتها | إشارة إعادة العمل في مرحلة المراجعة؛ تعريف الإنجاز | أسبوعي |
| تركز حمل المراجعة | مدى عدم تساوي توزيع عمل المراجعة في الفريق | حصة المراجعات المكتملة للفريق التي يتولاها أكثر المراجعَين انشغالًا خلال 4 أسابيع متحركة؛ تُستبعد مراجعات طلب الدمج الخاص ومراجعات الروبوتات. يُبلَّغ للفريق، لا بالاسم أبدًا | نسبة مئوية | أحداث المراجعة في منصة التحكم في الإصدارات، مجمَّعة إلى الفريق | التحسين المستمر؛ إدارة المعرفة | الملكية المشتركة للشيفرة؛ الملكية الجماعية | شهري |
| عدد طلبات الدمج الراكدة | طلبات الدمج المفتوحة أكثر من حد الفريق المتفق عليه | طلبات الدمج ما زالت مفتوحة وليست مسودات ويتجاوز عمرها منذ الجاهزية للمراجعة حد الفريق، تُحتسب وقت اللقطة؛ تُستبعد المسودات | عدد | قائمة طلبات الدمج المفتوحة في منصة التحكم في الإصدارات | تمكين التغيير؛ التحسين المستمر | عمر عنصر العمل؛ حد WIP | أسبوعي |
| معدل الإصلاح بعد الدمج | حصة طلبات الدمج المدموجة التي يتبعها تغيير تصحيحي قريبًا | طلبات الدمج المدموجة التي يتبعها خلال 14 يومًا إصلاح أو تراجع أو إصلاح عاجل مرتبط بالتغيير نفسه / طلبات الدمج المدموجة في الفترة؛ يُستبعد العمل المتابع المخطط الموسوم كذلك | نسبة مئوية | تاريخ التحكم في الإصدارات والمهام المرتبطة وسجلات الحوادث أو التغيير | تمكين التغيير؛ إدارة الحوادث | الجودة المضمَّنة؛ تعريف الإنجاز | شهري |
الزمن إلى أول مراجعة هو أكبر رافعة والقياس الذي ينبغي لمعظم الفرق أن تبدأ به. وزمن دورة المراجعة هو قياس نتيجته وجزء من أزمنة الانتظار الأطول التي نوقشت في الموضوع 2.2. والنافذة البالغة 14 يومًا وحد الركود مثالان؛ ويختار كل فريق قيمًا تناسب إيقاع إصداره ويكتبها. وحيث تغذي الأرقام صورة التسليم الأوسع تتولى عائلة DORA (انظر الموضوع 2.8، مقاييس DORA) وقياسات فشل التغيير (انظر الموضوع 4.4، فشل التغيير وإعادة العمل) الأمر.
التوصيات
قِس الانتظار قبل العمل
1. ابدأ بالزمن إلى أول مراجعة. هذا عادةً أكبر مساهم في زمن المراجعة وأرخص ما يُحسَّن. قِسه من سجل أحداث المنصة فلا يدخل أحد شيئًا. وأبلغ بالوسيط ومئين عالٍ، لأن وسيطًا من ثلاث ساعات مع مئين 95 من أربعة أيام يعني أن بعض التغييرات تُنسى.
2. استبعد الروبوتات والمسودات من الساعة، وقل ذلك. الفحوص الآلية وروبوتات تحديث الاعتماديات وأدوات التنسيق تنشئ تعليقات في ثوانٍ، وعدّها يجعل الانتظار يبدو ممتازًا. ابدأ الساعة حين يعلّم المؤلف التغيير جاهزًا، لا حين يُدفع الفرع أول مرة. وانشر هذه القواعد بجانب المخطط.
3. استخدم ساعات العمل واكتب تقويم الفريق. لا ينبغي أن يحمل طلب دمج فُتح متأخرًا يوم الجمعة عطلة نهاية أسبوع من الانتظار. والفريق الموزع على مناطق زمنية يحتاج قاعدة لساعات من تُحتسب، وكثيرًا ما يكون الجواب الصادق أن كلفة التسليم عبر المناطق هي ما يستحق الرؤية. بيّن الاختيار وأبقه ثابتًا.
شكّل العمل ليكون قابلًا للمراجعة
4. أبقِ طلبات الدمج صغيرة، وعامل الحجم عادة فريق. تتبع الوسيط والمئين 85 للحجم، وانظر إلى الكبيرة منها مجموعةً لا إخفاقات فردية. تجد الفرق عادةً أن التغييرات الكبيرة تأتي من أسباب قليلة: عمل لم يُقطّع بدقة كافية، أو خلط إعادة الهيكلة بسلوك جديد، أو انتظار طويل قبل الدمج. قطّع العمل ليفعل كل طلب دمج شيئًا واحدًا، وهذا يطابق أيضًا مبدأ الدفعة الصغيرة وراء التطوير القائم على الجذع والنشر المتكرر.
5. لا تضع سقف حجم صارمًا هدفًا. حد مثل "لا أكثر من 400 سطر" يدعو إلى تقسيم تغيير إلى قطع اصطناعية غير مقروءة كل منها منفردة أو تكسر البناء حين تُدمج وحدها. استخدم الحجم بادئًا للحوار في الاستعادة الرجعية، وأعطِ الفريق تقنيات للتقطيع، مثل مفاتيح الميزات وإعادة الهيكلة التمهيدية في طلب دمج خاص بها والدمج خلف علم.
6. اجعل طلب المراجعة صريحًا. طلب دمج لا يسمي مراجعًا ينتظر متطوعًا، والمتطوعون قلة. اتفقوا على من يُسأل، وكيف يُخطَر الفريق، وما التوقع للاستجابة، في اتفاقية العمل. وجدول مراجعة مشترك أو فترة مراجعة يومية يقلل الانتظار عادةً أكثر من أي إعداد في الأداة.
وزّع الحمل والمعرفة
7. راقب تركز الحمل خطرًا على مستوى الفريق. إذا تولى شخصان معظم المراجعات فتوافرهما يحد من تدفق الفريق وغيابهما يوقفه. راجع قياس التركز شهريًا، وتصرف عبر تصميم الفريق: بدّل المراجع الافتراضي، واقرن الأعضاء الأحدث بذوي الخبرة، واكتب مناطق الشيفرة التي لا يستطيع مراجعتها إلا شخص واحد. ولا تنشر قائمة ترتيب لكل شخص.
8. استخدم المراجعة لنشر المعرفة، واحمِ هذا الغرض. القيمة بعيدة المدى للمراجعة تشمل التعلم والملكية المشتركة والأسلوب المتسق، إلى جانب كشف العيوب. والبرمجة الزوجية والبرمجة الجماعية تنقلان بعض هذا التبادل إلى مرحلة أبكر؛ وحيث عمل زوج على تغيير فمراجعة أخف معقولة. اجعل الاختيار قرار فريق مكتوبًا في اتفاقية العمل، لتكون "عمل زوجي، فتُراجع خفيفًا" قاعدة ظاهرة لا عذرًا.
اضبط المراجعة نفسها
9. دع الأتمتة تتولى ما تجيده. التنسيق والتحقق من الأسلوب والفحوص الأساسية مكانها خط التسليم، ليذهب الانتباه البشري إلى التصميم والصحة والخطر. والتحليل الساكن للبرامج والاختبارات الآلية تقلل عدد جولات المراجعة التافهة. وتقول الجولات المتبقية حينها أكثر عن حوار التصميم وأقل عن خلافات الأسلوب.
10. اقرأ جولات المراجعة إشارة عن الوضوح لا عدّ عيوب. الجولات الكثيرة قد تعني أن المتطلب كان غامضًا، أو أن المؤلف يفتقر إلى السياق، أو أن المراجع طلب تغييرات ذوق، أو أن التغيير كان كبيرًا. وصفر جولات على كل طلب دمج قد يعني عملًا ممتازًا وقد يعني أن أحدًا لم ينظر. خذ عينة من حفنة من طلبات الدمج ذات جولات كثيرة أو قليلة على غير المعتاد واقرأوها معًا كفريق.
اقرن السرعة بالجودة، وأبقِ الزمن مرئيًا
11. أظهر دائمًا نظير جودة بجانب سرعة المراجعة. معدل الإصلاح بعد الدمج والحوادث المرتبطة بتغييرات حديثة وحصة العيوب المكتشفة بعد الإصدار هي الشركاء الطبيعيون (انظر الموضوع 4.4، فشل التغيير وإعادة العمل). فإن تحسن زمن المراجعة بينما ساء معدل الإصلاح فقد قايض الفريق الضمان بالسرعة، والعلاج حوار لا هدف. أظهر الاثنين على المخطط نفسه.
12. اربط المراجعة بصورة التدفق وبالعمل غير المخطط. تفيد المراجعة الأسرع فقط إن لم تضع المرحلة التالية العمل في طابور (انظر الموضوع 2.3، العمل قيد التنفيذ وطوابير الانتظار). وطلبات المراجعة العاجلة التي تقاطع العمل المخطط لها كلفتها الخاصة (انظر الموضوع 2.9، العمل التشغيلي والعمل غير المخطط).
طرق التلاعب وضوابط الحماية
| المقياس | كيف يُتلاعب به | ضابط الحماية المقترن (مقياس أو ممارسة) |
|---|---|---|
| الزمن إلى أول مراجعة | نشر "يبدو جيدًا" سريع أو رمز تعبيري استجابةً أولى؛ إسناد روبوت أو مراجع ودود؛ تعليم طلب الدمج جاهزًا فقط بعد أن يتفق أحد مسبقًا على النظر فيه | معدل الإصلاح بعد الدمج؛ عينة من الموافقات بلا تعليقات؛ اشتراط أن تكون الاستجابات الأولى جوهرية في اتفاقية العمل |
| زمن دورة المراجعة | الدمج دون انتظار المراجعة؛ تقسيم تغيير إلى قطع صغيرة ليمر أسرع؛ إغلاق طلب الدمج وإعادة فتحه لإعادة ضبط الساعة | عدّ طلبات الدمج المغلقة والمعاد فتحها؛ جولات المراجعة؛ معدل الإصلاح بعد الدمج؛ قواعد الفروع المحمية التي تشترط الموافقة |
| حجم طلب الدمج | استبعاد ملفات من العدّ؛ تقسيم تغيير واحد إلى قطع لا يمكن فهمها منفصلة؛ حشو الحجم بشيفرة مولَّدة | مراجعة قواعد التجاهل كل ربع؛ التحقق من أن القطع المقسمة تُبنى وتجتاز الاختبارات وحدها؛ قراءة عينة من الأصغر والأكبر |
| جولات المراجعة | الموافقة من المرور الأول لإبقاء العدد منخفضًا؛ نقل النقاش إلى المحادثة فلا يترك أثرًا؛ دفع المؤلفين إصلاحات كثيرة في إيداع واحد لإخفاء الجولات | معدل الإصلاح بعد الدمج؛ عينة من طلبات الدمج ذات الجولات الصفرية؛ إبقاء النقاش في طلب الدمج |
| تركز حمل المراجعة | تقسيم المراجعات إلى موافقات صغيرة كثيرة لنشر العدد؛ إسناد المراجعات لمن لديهم وقت فراغ دون معرفة | مراجعة معرفة المراجع بالمناطق الخطرة؛ مراقبة معدل الإصلاح بعد الدمج حسب المنطقة؛ إبقاء القياس على مستوى الفريق |
| عدد طلبات الدمج الراكدة | إغلاق طلبات الدمج الراكدة دون دمج؛ تحويلها إلى مسودات لإخفائها؛ رفع حد الركود | عدد طلبات الدمج المغلقة دون دمج؛ عدد المسودات الطويلة الأمد؛ مراجعة الحد مع الفريق كل ربع |
| معدل الإصلاح بعد الدمج | تسجيل الإصلاحات تحت عنصر عمل جديد بلا رابط؛ وسم العمل التصحيحي متابعة مخططة؛ تجنب القياس بتأخير الإصلاح خارج النافذة | المقارنة ببيانات الحوادث وفشل التغيير؛ عينة من عناصر المتابعة؛ تدقيق الوسوم المستخدمة |
القراءة الصحية هادئة. الزمن إلى أول مراجعة قصير والذيل قصير أيضًا، فلا ينتظر طلب دمج أيامًا. والحجم في نطاق يجده الفريق سهل القراءة، مع بضعة تغييرات كبيرة يستطيع الفريق شرحها. وجولات المراجعة منخفضة لكنها ليست صفرًا، والتركز معتدل، وعدد الراكدة صغير، ومعدل الإصلاح بعد الدمج مستقر. وحين يتحسن رقم بحدة فينبغي أن يتحقق أحد من أن ضابط حمايته المقترن لم يتحرك في الاتجاه الخاطئ.
المفاضلات: المزايا والعيوب
| النهج | نقطة القوة | نقطة الضعف |
|---|---|---|
| مراجعة سريعة بتوقعات استجابة صارمة | حلقات تغذية راجعة قصيرة؛ فقد سياق أقل للمؤلف؛ عمل قيد التنفيذ أقل | ضغط للموافقة سريعًا؛ تقاطع العمل المركز |
| مراجعة بطيئة دقيقة | قراءة متأنية للتصميم والخطر؛ نقل معرفة أقوى | زمن دورة أطول؛ تتراكم دفعات أكبر؛ ينتقل المؤلفون ويفقدون السياق |
| طلبات دمج صغيرة | أسهل قراءة وتراجعًا؛ تدفق أسلس | عبء أكبر لكل تغيير؛ قد تفتت ميزة إلى خطوات مربكة |
| طلبات دمج كبيرة | تسليمات أقل؛ الميزة كاملة ظاهرة دفعة واحدة | تصير المراجعات سطحية؛ أصعب في التراجع؛ انتظار طويل |
| موافقة مطلوبة من مالك مسمّى | مساءلة واضحة للمناطق الخطرة؛ تدعم تصريح التغيير | تخلق عنق زجاجة ونقطة فشل منفردة |
| فحوص آلية قبل المراجعة البشرية | تحرر الأشخاص للتصميم والخطر؛ متسقة | قد تخلق ثقة زائفة؛ تحتاج صيانة |
لا سياسة واحدة تفوز. الغاية تقصير الانتظار مع الحفاظ على التدقيق، والطريق المعتاد تغييرات أصغر وتوقعات مراجعة واضحة وأتمتة قوية للفحوص الروتينية واتفاق فريق على ما تعنيه مراجعة جيدة. وقياسات المراجعة أنفع ما تكون أسئلة لاستعادة رجعية وأقله نفعًا أهدافًا.
أسئلة للنقاش مع فريقك
1. أين يقضي طلب الدمج معظم حياته، منتظرًا أم مراجَعًا؟ اطلب من الفريق التخمين قبل النظر إلى البيانات، ثم اعرض الانقسام بين الزمن إلى أول مراجعة وبقية الزمن حتى الدمج. تتفاجأ معظم المجموعات بمقدار الانتظار. وعلى الميسّر أن يدوّن أي التخمينات كانت خاطئة ويسأل ماذا يقول كل تخمين خاطئ عن كيفية معايشة الفريق للمراجعة. واختم بتغيير واحد يهاجم أكبر انتظار.
2. كيف تبدو المراجعة الجيدة في هذا الفريق، وكيف سيعرف غريب؟ اذكر السلوكيات التي يقدّرها الفريق، مثل السؤال عن التصميم وفحص الاختبارات وشرح سبب الطلب. ثم اسأل أيها يترك أثرًا ظاهرًا في طلب الدمج. وناقش كيف تميز استجابة أولى جوهرية من رمزية دون مراقبة الأفراد. واتفقوا على وصف مكتوب قصير يوضع في اتفاقية العمل.
3. كم الحجم الكبير جدًا لنا، وماذا نفعل حين يكون العمل كبيرًا حقًا؟ انظر إلى توزيع الأحجام واختر بضعة طلبات دمج من الأكبر. اسأل لماذا كان كل منها كبيرًا وهل كان يمكن تقطيعه. وناقش تقنيات مثل مفاتيح الميزات وإعادة الهيكلة التمهيدية والدمج خلف علم. وعلى الميسّر أن يقاوم وضع حد رقمي وأن يتفق بدلًا منه على عادة يجربها الفريق شهرًا.
4. من يراجع أخطر شيفرتنا، وماذا يحدث حين يغيبون؟ اربط مناطق الشيفرة بالأشخاص القادرين على مراجعتها جيدًا. وانظر إلى تركز الحمل والمناطق التي لها مراجع مؤهل واحد. وناقش كيف تنمّون مراجعًا ثانيًا في كل منها، بالعمل الزوجي أو تدوير الإسناد. وأبقِ الحوار عن مرونة الفريق، لا ترتيب أعباء أي شخص.
5. لو تضاعفت سرعة مراجعتنا غدًا، فماذا نريد أن يكون صحيحًا عن الجودة؟ اطلب من المجموعة تسمية إشارات الجودة التي ستراقبها، مثل الإصلاحات بعد الدمج أو الحوادث المرتبطة بتغييرات حديثة أو عدد التراجعات. وتحقق هل هذه الإشارات ظاهرة حاليًا بجانب مخطط السرعة. وناقش ما سيكون علامة مبكرة على أن السرعة اشتُريت على حساب التدقيق. واتفقوا على النظير الذي يُعرض على اللوحة.
6. أي أرقام المراجعة قد نغري بتحسينها بطريقة لا تفيد؟ مرّ على كل قياس واسأل كيف يستطيع شخص تحت الضغط أن يجعله يبدو أفضل دون تحسين أي شيء. قارن الإجابات بجدول التلاعب أعلاه وأضف أفكار الفريق. والغاية تسمية الخطر قبل أن يقع. واتفقوا على أي ضابط حماية سيُراجع إلى جانب كل قياس.
المنظورات الأربعة
فرق المنتج والتسليم
تملك فرق التسليم عملية المراجعة وينبغي أن تملك قياساتها. وتستفيد أكثر من تقصير الانتظار باتفاقات بسيطة: فترة مراجعة يومية، وعملية طلب واضحة، وتغييرات صغيرة. وعليها أن تستخدم الأرقام في الاستعادات الرجعية، وتُبقي العمل قيد التنفيذ منخفضًا، وتقاوم إغراء تحسين مخطط واحد. والمراجعة أيضًا حيث يتعلم الأعضاء الأحدث الشيفرة، فاحمِ هذا الغرض.
فرق الخدمة والعمليات
تلتقي فرق العمليات بالمراجعة حيث تتغير شيفرة البنية التحتية والتهيئة وأتمتة أدلة التشغيل عبر طلبات الدمج. وهي عندها كثيرًا جزء من كيفية اعتماد تغيير قياسي وتوثيقه (انظر الموضوع 4.3، مقاييس تمكين التغيير). وعليها أن تتفق على أي التغييرات تحتاج مراجعة شخص ثانٍ، وكم بسرعة تُراجع الإصلاحات العاجلة، وكيف تُراجع التغييرات الطارئة لاحقًا، حتى يُفحص الإصلاح المتعجل. والمراجعة الرقيقة على تغيير خطر تظهر لاحقًا حادثة.
القيادة والحوكمة
ينبغي للقادة أن يعاملوا قياسات المراجعة إشارات عن صحة الفريق والتدفق لا درجات إنتاجية. وعليهم أن يطلبوا قياس الجودة المقترن كلما أُبلغ برقم سرعة، وأن يدعموا الوقت الذي تستغرقه المراجعة المتأنية، وأن يتجنبوا مقارنة الفرق بزمن المراجعة الخام، فالمستودعات والمخاطر تختلف. ويمكن لهيئات الحوكمة استخدام دليل المراجعة جزءًا من ضمان التغيير، شريطة أن تقبل أن عملية مراجعة موثقة ومأخوذة بعينات أقوى من عدّ الموافقات.
العملاء والمستخدمون
لا يرى العملاء طلبات الدمج، لكنهم يشعرون بنتائجها: كم بسرعة يصل إصلاح وكم مرة يجلب إصدار عيبًا جديدًا. وانتظارات المراجعة القصيرة تساعد الإصلاحات العاجلة على الوصول إليهم أسرع، والمراجعة المتأنية تساعد في إبعاد الأعطال عنهم. وحيث يكون لخدمة تاريخ إصدار أو عيوب منشور فيستفيد العملاء حين يُظهر الفريق تراجعات أقل وإصلاحات متكررة أقل عبر الزمن.
عمليًا: مثال على أجايل ITIL
تشغّل إدارة تقنية المعلومات في مستشفى إقليمي خدمة ويب لمواعيد المرضى، بناها فريق منتج من سبعة وتُشغَّل بمجموعة صغيرة لهندسة الموثوقية. كل الأرقام في هذا المثال توضيحية.
في مراجعة ربع سنوية يجد الفريق أن زمن دورة مراجعته له وسيط 26 ساعة عمل ومئين 85 يساوي 71 ساعة عمل (توضيحي). ويُظهر تقسيم الدورة أن وسيط الزمن إلى أول مراجعة 19 ساعة عمل، فمعظم التأخير انتظار. وحجم طلب الدمج له وسيط 180 سطرًا ومئين 85 يساوي 900 سطر (توضيحي)، ويتولى المراجعان الأكثر انشغالًا 68 في المئة من المراجعات (توضيحي). ومعدل الإصلاح بعد الدمج 9 في المئة (توضيحي).
يتخذ الفريق ثلاثة اتفاقات. يضعون فترة مراجعة يومية من 30 دقيقة، ويكتبون توقع استجابة أولى خلال يوم عمل في اتفاقية عملهم، ويدوّرون واجب "المراجعة أولًا" أسبوعيًا. ويعتمدون أيضًا عادة تقطيع للعمل الكبير، مستخدمين مفاتيح الميزات ليُدمج الجزئي منها بأمان. ولا يضعون حد حجم ولا هدفًا للزمن إلى أول مراجعة.
وبعد شهرين ينخفض وسيط الزمن إلى أول مراجعة إلى 6 ساعات عمل وينخفض المئين 85 لزمن دورة المراجعة إلى 34 ساعة عمل (توضيحي). وينخفض التركز إلى 52 في المئة (توضيحي)، ويبقى معدل الإصلاح بعد الدمج عند 9 في المئة.
ثم يلتقط الفريق خطر تلاعب. تُظهر عينة من الموافقات أن نحو ثلث الاستجابات الأولى يصل خلال دقائق ولا يقرأ إلا "LGTM" على تغييرات تمس منطق تذكير المواعيد. كان مكسب السرعة حقيقيًا جزئيًا وختمًا آليًا جزئيًا. ولم يتحرك معدل الإصلاح بعد الدمج بعد لأن الشيفرة المتأثرة تعمل بدورة شهرية. فيغيّر الفريق اتفاقية العمل بحيث يجب أن تتضمن الاستجابة الأولى سؤالًا أو تعليقًا عن جزء محدد من التغيير أو ملاحظة صريحة بما فُحص، ويضيف حصة الموافقات بلا تعليقات المأخوذة بعينة إلى مخطط مراجعته. ويتفقون أيضًا على أن التغييرات في منطق التذكير الموجه للمرضى تحتاج مراجعَين، أحدهما من مجموعة العمليات. ويدخل القرار، مع أسبابه، في سجل قرارات الفريق.
النظرة حسب القطاع
الشركات الناشئة. يستطيع فريق صغير أن يراجع في دقائق لأن الجميع يعرف الشيفرة، والخطر الرئيسي تخطي المراجعة حين يضيق الوقت. أبقِ القياسات قليلة: الزمن إلى أول مراجعة والحجم يكفيان. وأرسِ عادة التغييرات الصغيرة مبكرًا، فإدخالها أصعب بكثير حين تنمو الشيفرة والفريق.
الأعمال الصغيرة. كثيرًا ما يصون البرمجيات مطوّر أو اثنان، أو مورد خارجي. قد تكون المراجعة بيد زميل واحد أو بموظفي المورد. اسأل الموردين كيف يراجعون وهل يمكن مشاركة بيانات طلبات الدمج، واحتفظ بسجل بسيط بأي التغييرات راجعها من، لأن المراجعة هي الفحص الرئيسي ضد الأخطاء في فريق صغير.
المؤسسات الكبرى. الفرق والمستودعات وقواعد الموافقة الكثيرة تخلق تباينًا واسعًا. وحّد تعريفات الساعات والاستثناءات لتكون بيانات المنصة قابلة للمقارنة، لكن لا ترتب الفرق بزمن المراجعة الخام، فالخطر والشيفرة يختلفان. وانتبه إلى متطلبات المراجعة المفروضة للتدقيق التي تضيف انتظارًا دون تدقيق، وابحث عن فرص لاستبدال الموافقات اليدوية بفحوص آلية ومراجعة بعينات.
الحكومة والقطاع العام. كثيرًا ما تشترط قواعد فصل المهام ومسارات التدقيق والمشتريات موافقة مستقلة على التغييرات. تعاملوا مع هذه القواعد مدخلات للتصميم: سجّلوا من وافق على ماذا ومتى، وقيسوا الانتظار الذي تخلقه. وحيث يكتب الموردون الشيفرة فحددوا دليل المراجعة والوصول إلى البيانات في العقد (انظر الموضوع 8.5، التقارير التنظيمية والحكومية).
دراسة الجدوى: الدوافع والعائد على الاستثمار وإجمالي تكلفة الملكية
الدافع تقصير الجزء من التسليم البطيء والقابل للسيطرة معًا، مع الحفاظ على فوائد مراجعة الأقران: عيوب أقل ومعرفة مشتركة ومسار تدقيق. فطلبات الدمج المنتظرة تحجب العمل المنتهي عن المستخدمين، وتزيد كلفة تبديل السياق على المؤلفين، وتجعل تعارضات الدمج أرجح مع تقادم الفروع. وتقليل الانتظار يؤتي لذلك ثمره في تسليم أسرع وإعادة عمل أقل وإحباط أقل.
وكلفة جمع هذه القياسات منخفضة حين توفر منصة التحكم في الإصدارات سجل أحداث وواجهة برمجية. والكلف الرئيسية وقت تعريف الساعات والاستثناءات، وبناء التقرير أو تهيئته، ومراجعة الأرقام بانتظام. والكلفة الأكبر سلوكية: الوقت الذي يمنحه الناس للمراجعة السريعة، وهو ينافس عملًا آخر. وهذا الوقت هو الاستثمار الحقيقي، وينبغي أن يُدرج في الميزانية لا أن يُعامل مجانيًا.
ويظهر العائد في زمن دورة مراجعة أقصر وطلبات دمج راكدة أقل ومعدل إصلاح بعد الدمج ثابت أو متناقص. تجنب الادعاء مسبقًا بنسبة تحسن معينة، لأن النتائج تعتمد على نقطة البدء والفريق. والدراسة الموثوقة تقارن توزيعات الفريق نفسه قبل وبعد، مع نظير الجودة، لا اقتباس أرقام من منظمات أخرى. ويذكر كتاب Accelerate لعام 2018 بحثًا يربط الممارسات التقنية والثقافية بأداء التسليم وهو مصدر معقول للحجة العامة، لكن أرقام فريقك تأتي من بياناتك.
الأنماط المضادة والمزالق
- ترتيب المراجعين أو المؤلفين. قوائم ترتيب فردية لعدد المراجعات المنجزة أو الأسطر المتغيرة تفسد التعاون. أبلغ على مستوى الفريق واستخدم الأرقام لتعديل عادات الفريق.
- استهداف الزمن إلى أول مراجعة بلا نظير جودة. النتيجة الختم الآلي. أظهر معدل الإصلاح بعد الدمج وعينة من الموافقات بلا تعليقات بجانب كل مخطط سرعة.
- وضع حد حجم صارم. تقسّم الفرق العمل اصطناعيًا للامتثال. استخدم الحجم حوارًا وعلّم تقنيات التقطيع بدلًا منه.
- عدّ صفر تعليقات نجاحًا. قد تعكس الموافقة غير المفحوصة ثقة أو غفلة. خذ عينات من هذه الطلبات واقرأوها معًا.
- عدّ نشاط الروبوتات مراجعة. التعليقات الآلية تجعل الانتظار يبدو قصيرًا. استبعد الروبوتات من الساعة ومن قياسات الحمل.
- تجاهل المناطق الزمنية والتقاويم. الزمن الخام للساعة يجعل انتظارات عطلة الأسبوع والمناطق تبدو مراجعة بطيئة. استخدم ساعات العمل وسمِّ التقويم.
- ترك قائمة الراكدة تنمو. طلبات الدمج القديمة تراكم تعارضات وتفقد السياق. راجع القائمة أسبوعيًا وإما ادمج كل عنصر أو أعد العمل عليه أو أغلقه بسبب.
نموذج النضج
| البُعد | 1 البدء | 2 التطوير | 3 التوحيد | 4 الإدارة | 5 التنسيق |
|---|---|---|---|---|---|
| التعريف والساعات | زمن المراجعة يُخمَّن أو يُبلَّغ بالإحساس | بعض الفرق تصدّر الأزمنة من المنصة بقواعدها | تعريف مكتوب واحد لكل ساعة، مع استثناءات للروبوتات والمسودات والتقاويم | تُراجع التعريفات بوتيرة؛ تُسجَّل التغييرات بأسبابها | تتواءم التعريفات عبر الفرق والموردين وتُنقَّح حين تكفّ عن الاستنارة بها في القرارات |
| ممارسة المراجعة | المراجعات تحدث حين يلاحظ أحد | أعراف غير رسمية في بعض الفرق | اتفاقية عمل مكتوبة عن الطلبات وتوقعات الاستجابة وما تغطيه المراجعة | تُعدَّل الأعراف من البيانات؛ يُتتبع نشر المعرفة ومناطق الخطر | تُنسَّق ممارسة المراجعة عبر الفرق والموردين، مع أتمتة تتولى الفحوص الروتينية |
| نظير الجودة | لا رابط بين المراجعة والعيوب | نظرة عرضية على الإصلاحات بعد الدمج | معدل الإصلاح بعد الدمج معروض بجانب سرعة المراجعة | تُراجع ضوابط الحماية بانتظام؛ تُقرأ الموافقات المأخوذة بعينات | يُربط دليل المراجعة بضمان التغيير وتعلّم الحوادث عبر الخدمات |
| الاستخدام في التحسين | الأرقام غير مستخدمة | تُعرض في بعض الاستعادات الرجعية | يراجعها الفريق المالك بوتيرة ثابتة | تفضي الفجوات إلى عمل تحسين مخطط وممول | تتدفق أفكار التحسين من الفرق إلى الممارسة المشتركة وتعود |
قائمة التحقق
- ساعات الزمن إلى أول مراجعة وزمن دورة المراجعة مكتوبة، ببدايتها ونهايتها واستثناءاتها.
- الروبوتات والمسودات وطلبات الدمج المغلقة دون دمج مستبعدة أو محتسبة منفصلة، والقواعد ظاهرة.
- تُبلَّغ الأزمنة وسيطًا ومئينًا عاليًا بساعات العمل.
- يُقاس حجم طلب الدمج بقائمة تجاهل متفق عليها للملفات المولَّدة والمضمَّنة.
- للفريق اتفاق مكتوب عن كيفية طلب المراجعات وكم بسرعة يُتوقع أول رد.
- يُبلَّغ بتركز حمل المراجعة على مستوى الفريق فقط.
- يُعرض معدل الإصلاح بعد الدمج أو نظير جودة آخر على المخطط نفسه مع سرعة المراجعة.
- تُقرأ كل شهر عينة من الموافقات بلا تعليقات والسريعة جدًا.
- تُراجع قائمة طلبات الدمج الراكدة أسبوعيًا.
- تُستخدم بيانات المراجعة في الاستعادات الرجعية لا في التقييم الفردي.
- مناطق الشيفرة ذات المراجع المؤهل الواحد مسرودة ولها خطة.
مطالبات الذكاء الاصطناعي
صُغ تعريفات الساعات لقياسات المراجعة.
I want to define review metrics for [team or repository]. Our platform is
[version control platform] and our workflow is [describe: draft pull requests,
required approvals, merge rules, bots in use]. Draft precise definitions for time
to first review and review cycle time, stating the event that starts and stops
each clock, what is excluded (bots, drafts, closed unmerged), how working hours
are handled for [time zones and working calendar], and which percentiles to
report. Do not invent benchmark values or tool features. List your assumptions and
the questions I should answer to finish the definitions.
حلّل تصدير بيانات مراجعة.
Here is an anonymized export of merged pull requests for [team] over [period],
with columns [list columns, for example ready time, first review time, merge time,
lines changed, review rounds, linked fix flag]: [paste data or summary]. Compute
the median and 85th percentile for each time measure and for size, split the
review cycle into waiting and reviewing, and point out patterns that deserve a
conversation. Do not rank individuals, and do not compare with outside
benchmarks. List your assumptions and any data quality problems you notice.
اعثر على مخاطر التلاعب في قياسات مراجعتنا.
Our team reports these review metrics: [list metrics and how each is calculated].
The pressures on us are [for example a release deadline, a leadership target, a
supplier contract]. For each metric, describe plausible ways it could be improved
without improving review, the early signs of each, and a paired guardrail metric
or practice that would catch it. Do not invent statistics. List your assumptions
and tell me what you would need to know to rank the risks.
حضّر استعادة رجعية عن تدفق المراجعة.
Prepare a 45-minute retrospective agenda for [team] on review flow. Inputs: time
to first review [value], review cycle time [value], median size [value], load
concentration [value], and post-merge fix rate [value], all labeled with their
definitions. Suggest questions that surface causes, one small experiment the team
could run for [duration], and the quality signal to watch during the experiment.
Do not invent causes or targets. List your assumptions and the data I should bring.
مهارات الذكاء الاصطناعي
- مهارة مقاييس أجايل ITIL: استخدمها للعثور على الموضوع الذي يعرّف قياس تدفق أو جودة ذا صلة وضابط الحماية الذي ينبغي أن يجاور قياس مراجعة.
- مهارة صيانة مقاييس أجايل ITIL: استخدمها للتحقق من أن تعديلات هذا الموضوع تُبقي القالب وجدول التلاعب والإحالات المتبادلة متسقة.
النقاط الرئيسية
- معظم تأخير المراجعة انتظار، فقِس الزمن إلى أول مراجعة وزمن دورة المراجعة توزيعاتٍ بساعات العمل.
- طلبات الدمج الأصغر تُراجع أسرع وبعناية أكبر؛ علّم التقطيع بدل فرض سقف حجم.
- اقرن كل قياس سرعة بنظير جودة، مثل معدل الإصلاح بعد الدمج، واقرأ الاثنين معًا.
- عامل حمل المراجعة سعة فريق وأبلغ بالتركز على مستوى الفريق، لا ترتيبًا للأشخاص أبدًا.
- قياسات المراجعة أسئلة لاستعادة رجعية، وتخدم الفريق الذي يملك العمل.
المراجع والقراءة الإضافية
- 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.