انتقل إلى المحتوى
اتصل بي

قانون التوثيق المتأخر

البرمجة والأخطاء

التوثيق، حين يوجد، يصف بدقة بالغة النسخة السابقة من البرنامج.

— مجهول, الفولكلور المعلوماتي
VIDEO.EXE16:9

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

السبب بسيط. الكود يركض، والتوثيق يمشي. وحين يكتب أحدهم أخيرًا دليل النسخة الثانية، يكون المبرمجون قد بدأوا الشجار حول الرابعة.

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