إزاي تبني ثقافة مراجعة الكود؟ ملاحظات من عشر سنين خبرة

أنا معاك في قاعدة الأجزاء الصغيرة بس صعبة عملياً. أحياناً التعديل بيكون كبير بطبيعته.

الحل عندنا بقى إننا قبل ما نبعت التعديل الكبير، نكتب النهج في صفحة واحدة ونشاركها. قراءة خمس دقايق بتوفر نقاش مراجعة ساعة.

أسوأ حاجة تكتشف إن النهج غلط بعد ما تكتب 500 سطر. في النقطة دي محدش عايز يرجع، والقرار السيء يطلع للإنتاج.

ممكن أقول حاجة كوني مبتدئ؟

أصعب حاجة عندي مش إني آخذ التعليق بشكل شخصي. لما يجيني تعليق مش فاهمه، بتكاسل أسأل تاني، بحس إني هبوظ نفسي. وبعدين أحاول أحزر وأصلح غلط.

مش عارف ده بس عندي ولا عند ناس تانية، بس يمكن يكون عند غيري كمان.

مش عندك بس، دي حاجة شائعة جداً، ومهمتنا إحنا نصلحها مش مهمتك.

حاجتين نفعت عندنا. الأولى، لما تكتب تعليق اكتب السبب كمان. بدل "غير المكان ده"، قول "هنا بيحصل خطأ في الحالة دي، عشان كده الأفضل يكون كذا". لو في سبب، الحاجة إنك تسأل بتقل.

التانية، لما يبقى أكتر من جولتين مراسلة، حولوا النقاش لمحادثة صوتية. اجتماع 15 دقيقة أسرع من 15 تعليق وأقل إجهاداً بكتير.

وقول كمان: مفيش حاجة اسمها سؤال غبي. السؤال اللي إنت بتسأله، تلات ناس في الفريق كمان عايزين يسألوه بس مش بيسألوا. لما تسأل، بتعمل خير لأربعهم مرة واحدة.

ترك نقاش التنسيق للأداة لوحده أكبر مكسب. بيتظبط في أسبوع، وبيوفر وقت لسنوات.

تحذير من إدارة المشروع: اكتبوا مدة المراجعة في الخطة.

عندنا صار كذا، ما حسبنا المراجعة جزء من الشغل لفترة طويلة، كان في الخطة وقت التطوير بس. النتيجة: كل مراجعة كانت تتشوف كـ "شيء يبطئ الشغل" وتصير بشكل صوري.

من يوم ما كتبناها في الخطة، ما حد يعرقل المراجعة، لأنها صارت جزء من الخطة نفسها مو شيء يبطئ الشغل.

عانيت من نفس الشيء.

بالضبط هكذا. إذا لم تقم بصياغة هذا كتابيًا من البداية، فستنشأ خلافات لاحقًا.

دعني أتركها كملاحظة، قد تكون مفيدة.

أوافقك الرأي تمامًا. فعل الجميع لشيء ما لا يعني أنه صحيح.

اكتبوا إذا كانت لديكم أسئلة، سأجيب قدر استطاعتي.

حدث معي العكس تماماً، لذلك أكتب هذا. المسألة ليست الرقم، بل الأساس الذي بُني عليه.

إذا كتبت النتيجة هنا، فستفيد الآخرين أيضاً.

دعني أترك تنبيهًا. انظروا أولاً إلى البيانات المتاحة لديكم عند اتخاذ القرار.

لا تتحسن أي عملية لا يتم توثيقها، لأنك لا تعرف ما الذي يجب إصلاحه. إذا كان هناك من يفعلها بطريقة أخرى، فأنا فضولي لمعرفة ذلك.

أتابع الموضوع.

عندنا نفس المشكلة.

تم الحفظ.

سأجمع الموضوع، لأن هناك عدة إجابات مختلفة. ابدأ بتجربة صغيرة، لا تربط كل شيء دفعة واحدة.

لو كنت مكانك، لسلك هذا المسار.

أرجو المعذرة، لكن هذا لا ينطبق في كل الحالات. الحلول التي تنجح على نطاق صغير تنهار عند التوسع، تعلمت هذا متأخراً.

صححوا لي إن أخطأت.

نادرًا ما تجد مقالاً يشرح الأمر بهذه الوضوح. لا تترددوا في السؤال، فالسائل يدفع ثمناً أقل دائماً.

إذا كان النطاق يتوسع، فيجب أن يتوسع إما الجدول الزمني أو الميزانية. لا يوجد خيار ثالث. إذا كان هناك من يفعلها بطريقة أخرى، فأنا فضولي لمعرفة ذلك.

موضوع في الوقت المناسب تمامًا.

أخذت ملاحظة، شكرًا لك.