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

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

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

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

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

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

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

حدّ الدليل

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

والحد لا يفصل بين الهاتف والمكتب؛ بل بين الدليل المتاح والدليل الغائب.

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

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

العمودان

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

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

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

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

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

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

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

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

يفتح الوكيل تغييرين في يوم واحد.

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

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

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

ما تحدده السياسة قبل حدّ الدليل

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

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

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

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