لماذا نوثّق كل شيء

نوثّق القرارات والشيفرة والعملية أثناء العمل، فتبقى المعرفة مع المشروع, ويمكن لأي أحد، بما فيك أنت، أن يلتقطها ويواصلها.

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

كتابة الأمور أثناء التقدّم تحوّل المعرفة الخاصة إلى معرفةٍ مشتركة، فيبقى الفريق سريعاً حتى مع تبدّل الناس والأولويات.

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

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

والمعيار هو «مفيد» لا «كامل». عشر صفحات واضحة تجيب أسئلة حقيقية خير من مستنقع ويكي يجيب عن كل شيء إجابة رديئة, والمستند الذي له مالك وموعد مراجعة يبقى حياً، بينما يبدأ المجهول التعفن يوم كتابته.