5.4توثيق وإجراءات تقنية المعلومات
الأساسي في 30 ثانية
- معرفة محفوظة «في الرأس» خطر: غياب، مغادرة، نسيان — فيتوقّف النشاط لانعدام من يعرف.
- ثلاث صيغ مفيدة: إجراء (كيف نفعل)، runbook (ماذا نفعل عند عطل)، قاعدة معرفة (حلول مجمّعة).
- التوثيق الجيّد حيّ: محدَّث، قابل للإيجاد، وقابل للتنفيذ — وإلا ضلّل.
حالة مصغرة متسلسلة — سفيان يكتب runbook قبل إجازته
سفيان، تقني الدعم في مؤسسة صغيرة للتوزيع بالجزائر، هو الوحيد الذي يعرف إعادة تشغيل خادم الملفات حين يتوقّف. سيغادر قريباً في إجازة ولا يريد ترك الفريق في ذعر. فيطبّق نهج القسم: يكتب runbook «خادم الملفات لم يستجب»، بخطوات دقيقة وبالترتيب، مفهومة لزميل غير خبير. يدع زميلاً آخر يختبره: وحيثما يتعثّر، يصحّح التوثيق. يرتّب الـ runbook في مكان قابل للإيجاد، ويدوّن تاريخ التحديث، فيقلّص بذلك الاعتماد على شخص واحد.
حالة مستقلة لهذا القسم: تعود في الدرس والمخطط والنص والتحدي 48 ساعة للقسم 5.4.
1. المعرفة في الرأس = خطر
حين لا توجد عملية إلا «في رأس» شخص واحد، تعتمد المؤسسة عليه: غياب، مغادرة، نسيان، فيتوقّف كل شيء. التوثيق يحوّل معرفة شخصية إلى معرفة مشتركة. يعيش سفيان ذلك: وحيداً في معرفة إعادة تشغيل خادم الملفات، يهيّئ الآخرين. ليست أوراقاً — إنها استمرارية وجودة ووقت مُوفَّر.
2. إجراءات، runbooks، قاعدة معرفة
ثلاث صيغ مفيدة. الإجراء يصف كيف نُنجز عملية (تهيئة محطة، إنشاء حساب). والـ runbook مسار دقيق لموقف معيّن، غالباً عطل («ماذا نفعل إن توقّف الخادم X عن الاستجابة»). وقاعدة المعرفة تجمع حلول المشكلات المصادَفة، قابلة لإعادة الاستخدام من الفريق كله وأحياناً من المستخدمين. يجمع سفيان الثلاث حسب الحاجة.
3. التوثيق الجيّد حيّ
التوثيق المفيد محدَّث وقابل للإيجاد وقابل للتنفيذ: خطوات واضحة ومُختبَرة يستطيع غيرك اتّباعها بدونك. نحدّثه حين تتغيّر الحقيقة — وإلا ضلّل — ونكتبه للقارئ لا لأنفسنا. التوثيق أثناء العمل يكلّف قليلاً؛ وإعادة البناء لاحقاً تكلّف كثيراً. ويدوّن سفيان تاريخ التحديث بصورة منهجية.
🔎 مثال ملموس — 🔎 مثال ملموس — الزميل في إجازة
يتصوّر سفيان عطل خادم الملفات أثناء غيابه:
بلا runbook: تعطّل حتى عودته، أو تجربة محفوفة بالمخاطر
مع runbook «خادم الملفات لم يستجب»:
خطوات مُختبَرة → زميل يعيد الخدمة خلال 20 دقيقةالقراءة: الـ runbook يجعل الفريق مكتفياً ذاتياً أمام العطل.
الدرس: التوثيق يعني عدم الاعتماد على شخص واحد.
مفردات القسم
- الإجراء
- وصف خطوة بخطوة لعملية تُنجَز.
مثال بسيط: يوثّق سفيان إنشاء حساب مستخدم.
ما ليس كذلك: شرح غامض متروك شفهياً.
رد فعل: الإجراء = كيف نفعل.
- Runbook
- مسار دقيق لموقف معيّن (غالباً عطل).
مثال بسيط: runbook «خادم الملفات لم يستجب» عند سفيان.
ما ليس كذلك: الارتجال عند وقوع العطل.
رد فعل: runbook = ماذا نفعل عند عطل.
- قاعدة المعرفة
- مجموعة قابلة لإعادة الاستخدام لحلول مشكلات مصادَفة.
مثال بسيط: يدوّن فيها سفيان الحلول التي وجدها للفريق.
ما ليس كذلك: حلّ الحادث نفسه عشر مرات من الصفر.
رد فعل: تكثيف الحلول.
- التوثيق الحيّ
- توثيق محدَّث، قابل للإيجاد والتنفيذ، يُحدَّث حين تتغيّر الحقيقة.
مثال بسيط: يؤرّخ سفيان كل مستند ويصحّحه بعد الاختبار.
ما ليس كذلك: مستند لا يُحدَّث أبداً ويضلّل.
رد فعل: محدَّث، قابل للإيجاد، قابل للتنفيذ.
- عامل الحافلة (Bus factor)
- عدد الأشخاص الذين لو غابوا لتوقّف النشاط؛ والتوثيق يرفعه.
مثال بسيط: يرفع سفيان عامل الحافلة بمشاركة معرفته.
ما ليس كذلك: جعل كل شيء يرتكز على شخص واحد.
رد فعل: كلما زادت مشاركة التوثيق، قلّ الاعتماد.
في التطبيق — في التطبيق — كتابة runbook
- اختر عطلاً متكرّراً تعرف حلّه (كخادم ملفات سفيان).
- اكتب الخطوات الدقيقة، بالترتيب، كأنها لزميل غير خبير.
- دع غيرك يختبره: إن تعثّر، فالتوثيق ما يجب تصحيحه.
- احفظه في مكان قابل للإيجاد ودوّن تاريخ تحديثه.
نص خطوة بخطوة — اكتب runbook مثل سفيان (10 دقائق)
1) اختر عطلاً تعرف حلّه. 2) اكتب العنوان كما يُوصَف شفهياً. 3) أدرج الخطوات الدقيقة، بالترتيب، بالمسارات والأوامر الدقيقة. 4) أضف النهاية السعيدة: كيف نتحقّق أن الأمر عاد. 5) أعطه لزميل غير خبير ليختبره. 6) صحّح كل موضع يتعثّر فيه، ثم احفظه وأرّخه.
السؤال السحري للتحقّق من توثيق: «هل ينجح غيري بدوني؟». إن لا، فصحّح.
نموذج للنسخ واللصق — الـ runbook لديّ
العنوان: ___ (مثال: «خادم الملفات لم يستجب»)
العَرَض المرصود: ___
1. ___
2. ___
3. ___
التحقّق من العودة: ___
مكان الحفظ: ___ (قابل للإيجاد من الفريق)
آخر تحديث: ___
القاعدة: محدَّث · قابل للإيجاد · قابل للتنفيذ.runbook عطل
يكتب سفيان ماذا نفعل إن توقّف خادم الملفات عن الاستجابة، خطوة بخطوة.
إجراء روتيني
يوثّق سفيان تهيئة محطة قياسية للمؤسسة الصغيرة.
قاعدة معرفة
يكثّف سفيان الحلول التي وجدها كي لا يبدأ الفريق من الصفر.
توثيق حيّ
يؤرّخ سفيان مستنداته ويصحّحها حين تتغيّر التهيئة.
✓ ممارسات جيدة
- وثّق أثناء العمل: إنه أقلّ كلفة بكثير من بعده.
- اكتب للـقارئ: خطوات واضحة، مُختبَرة من غيرك.
- أبقِ التوثيق محدَّثاً وقابلاً للإيجاد.
✗ أخطاء شائعة
- إبقاء المعرفة في الرأس.
- كتابة توثيق لا يُحدَّث أبداً: إنه يضلّل.
- التوثيق لنفسك، غير مقروء للآخرين.
النقاط الأساسية
- المعرفة غير الموثَّقة خطر توقّف.
- إجراء (كيف نفعل)، runbook (ماذا عند العطل)، قاعدة معرفة (حلول مجمّعة).
- التوثيق الجيّد محدَّث، قابل للإيجاد، قابل للتنفيذ.
- التوثيق أثناء العمل أرخص من إعادة البناء بعده.
تحدٍّ 48 ساعة — طبّقه غدًا
مثل سفيان، اكتب runbook واحداً لعطل تعرف حلّه: عنوان، عَرَض، خطوات دقيقة بالترتيب، وتحقّق نهائي. دع غيرك يختبره وصحّح حيث يتعثّر. احفظه في مكان قابل للإيجاد وأرّخه.
- أستطيع شرح لماذا المعرفة غير الموثَّقة خطر.
- أميّز الإجراء والـ runbook وقاعدة المعرفة.
- أعرف ما يصنع توثيقاً جيّداً: محدَّث، قابل للإيجاد، قابل للتنفيذ.
أسئلة شائعة
ألا يُضيّع التوثيق الوقت؟
قليلاً على المدى القصير؛ لكنه يوفّر كثيراً على المدى المتوسّط: تشخيصات أقلّ، اكتفاء ذاتي للفريق، استمرارية عند الغياب. الكلفة الحقيقية معرفة تختفي مع صاحبها.
كيف أعرف أن التوثيق جيّد؟
دع غيرك ينفّذه: إن نجح دون الرجوع إليك، فالتوثيق قابل للتنفيذ. وكل موضع تعثّر يدلّ بالضبط على ما يجب تصحيحه.
ما الفائدة الكبرى من توثيق إجراءات تقنية المعلومات؟