أفضل اختبار لهندستك هو ما يحدث عندما تبتعد. إذا اضطر أحدهم لمراسلتك "كيف يعمل هذا؟" — فقد فشلت. يجب أن تستمر الأنظمة في العمل. يجب أن تستمر خطوط الأنابيب في النشر. يجب أن تستمر لوحات المعلومات في التحديث.
هذا هو الجزء الأكثر تعمّدًا في ممارستي الهندسية: البناء للشخص الذي سيأتي بعدي.
الاختبار
قبل أن أعتبر أي نظام "مكتملًا"، أسأل: "هل يستطيع مهندس متوسط المستوى، لم يرَ هذه الشيفرة من قبل، تشغيلها دون الاتصال بي؟"
إذا كانت الإجابة لا، فأنا لم أنتهِ بعد. قد تعمل الشيفرة، لكنها ليست مكتملة.
كيف تبدو "قابلية التشغيل"
1. README تجيب على أول 5 أسئلة
كل مهندس جديد يطرح نفس الأسئلة الخمسة:
- ماذا يفعل هذا؟
- كيف أشغّله محليًا؟
- كيف أنشره؟
- أين توجد السجلات؟
- بمن أتصل إذا تعطل؟
\\
