مراجعة الشيفرة من الهاتف تحتاج تسليمًا واضحًا

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

الهاتف غيّر ما تستطيع التحقق منه، وترك مسؤوليتك عن الاعتماد حيث كانت تمامًا.

ما الذي غيّره الهاتف

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

هذا فرق في الدليل المتاح، ويختلف باختلاف الأداة والمستودع والتغيير الذي أمامك. أما الثابت فهو وزن الاعتماد: فالاعتماد ما زال يحمل اسمك ومسؤوليتك أيًّا كانت الشاشة التي أصدرته منها.

ووكلاء البرمجة يجعلون تجاهل هذا السؤال أصعب، لأن التغييرات قد تصل للمراجعة دون أن تنتظر جلوس أحد إلى مكتب. وقد يزيد عدد هذه التغييرات أو ينقص، وتبقى المسؤولية عن كل واحد منها كما هي.

حدّ الدليل

سؤال واحد تطرحه على التغيير الذي أمامك.

هل كل ما يعتمد عليه هذا القرار ظاهر وقابل للفحص في الواجهة التي أعتمد منها؟

والظاهر ما تستطيع رؤيته، والقابل للفحص ما تستطيع التحقق منه دون افتراض. فإن كان الجواب نعم، فاعتمد من مكانك. وإن كان القرار يستند إلى شيء يلزمك فتح واجهة أخرى لرؤيته، فأجّله. وهذا السؤال يحكم التغييرات المعتادة. وقد يضع الفريق أيضًا أصنافًا من التغييرات خارج الاعتماد من الهاتف على الدوام، لأن أثرها يستدعي بيئة مراجعة مختلفة. وتلك حدود سياسة، لا إخفاق في الدليل.

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

العمودان

اكتب الحد مرة واحدة في عمودين، فيكفّ الفريق عن إعادة تقريره مع كل تغيير ومع كل تقلّب في المزاج.

اعتمد من مكانك حين:

• يكون المنطق مقروءًا في التغيير نفسه، وتستطيع تتبعه من أوله إلى آخره
• تعرض الواجهة الفحوص، وتعرف ما الذي تغطيه تلك الفحوص
• ترى ما يمسّه التغيير وما يتركه على حاله

وأجّل إلى واجهة أخرى حين:

• يعتمد القرار على النتيجة كما تظهر على الشاشة، أو على حالة التطبيق أثناء تشغيله، أو على إعداد لا تعرضه الواجهة
• يمسّ التغيير مسارًا يصل فيه الخطأ إلى الأموال أو صلاحيات الوصول أو بيانات العملاء
• تحتاج إلى ملف مرتبط به، أو إلى ترحيل لقاعدة البيانات، أو إلى محادثة، لتحكم على صوابه

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

اعتماد يختلف فيه الحدس عن الحد

ما يلي سيناريو مركّب كُتب لهذا المقال. لا مستودع حقيقي، ولا فريق حقيقي.

يفتح الوكيل تغييرين بعد ظهر اليوم نفسه.

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

والثاني يتجاوز مئة سطر بكثير: استبدال نصوص التعريف بالتطبيق في عدة شاشات، وبلغتين. يتردد الحدس أمام الحجم. لكن التغيير يمسّ النص وحده، والواجهة تعرض الشاشات المتأثرة، والفحوص الظاهرة تغطي النصوص المتأثرة، والملفات المحيطة لا تُظهر أي تغيير في الوظائف. وكل ما يلزم للحكم على هذا التغيير متاح في واجهة المراجعة. الحد يقول: اعتمد.

كان الحدس يقرأ الحجم في الحالتين، وكان الحد يقرأ الدليل، فعكس الجوابين.

ما يُؤجَّل في كل الأحوال

بعض الاعتمادات مؤجلة دائمًا إلى واجهة أخرى. وتدوينها مسبقًا يحسم الجدل في اللحظة التي يكون فيها أعلى كلفة، أي حين يكون الأمر مستعجلًا.

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

ضع حدّ الدليل قبل وصول التغيير المستعجل التالي. واسأل: هل أستطيع أن أرى وأفحص من هنا كل ما يتوقف عليه هذا الاعتماد؟ إذا كان الجواب لا، فلا عيب في الهاتف ولا عيب في الانتظار. فالقرار يحتاج فقط إلى واجهة تستطيع إظهار الدليل الغائب.

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