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