يسألك زميل انضم إلى الفريق قبل أسبوع في المحادثة: «كيف نضيف مطعماً جديداً إلى النظام؟»، وهذه رابع مرة يأتي فيها السؤال نفسه هذا الشهر. فتبحث في القناة عن رسالة كتبها مدير العمليات قبل ثمانية أشهر، وتجدها بعد دقائق تحت مئات الرسائل، ثم تتذكر أن الخطوة الثالثة فيها تغيرت عندما انتقلتم إلى نظام المحاسبة الجديد، وأن التغيير نفسه مكتوب في ملف على Google Drive لا يعرف مكانه إلا شخص واحد، وهذا الشخص في إجازة. فتكتب الجواب من ذاكرتك، وتعرف أنك سوف تكتبه مرة خامسة الشهر القادم.
إذا كان هذا يحدث في فريقك فأنت لست وحدك، ففي استبيان Stack Overflow للمطورين لسنة 2024 قال 61% من المشاركين إنهم يقضون أكثر من 30 دقيقة كل يوم في البحث عن إجابات وحلول لمشكلات عملهم، ويشمل ذلك سؤال الزملاء وانتظار ردهم. والمشكلة هنا ليست أن المعرفة غير موجودة، فهي موجودة ولكنها متفرقة: في رسائل المحادثة، وفي ملفات بأسماء متشابهة، وفي رأس شخص واحد يعرف «كيف تعمل الأمور». والحل الذي تصل إليه أغلب الفرق في النهاية هو قاعدة معرفة Knowledge Base واحدة على شكل Wiki يكتب فيها الجميع ويبحث فيها الجميع، ولكن الذي لا يقال كثيراً هو أن أغلب هذه المشاريع تفشل بعد سنة، فتتحول الـ Wiki إلى مقبرة صفحات قديمة لا يثق بها أحد، ويعود الناس إلى السؤال في المحادثة.
وسوف نتابع في هذا المقال فريقاً واحداً من أول السطر إلى آخره، وهو فريق من 14 شخصاً في شركة ناشئة تبيع نظام نقاط بيع Point of Sale للمطاعم والمقاهي، فيه مطورون وفريق دعم وعمليات ومبيعات، ومعرفته اليوم موزعة بين قنوات المحادثة والمجلد المشترك وملفات README في المستودعات. وهذا الفريق نفسه سوف نستخدمه في بقية مقالات المرحلة، لكي تكون المقارنة بين الأدوات على محتوى واحد.
وسوف نناقش في هذا المقال ما يلي:
- أين تضيع معرفة الفريق، ولماذا لا تكفي المحادثة مكاناً لها.
- ما هي الـ Wiki، والفرق بينها وبين المجلد المشترك والتوثيق مع الكود.
- أنواع الصفحات بإطار Diátaxis، وكيف تقسم المساحات وتكتب العناوين والقوالب.
- ملكية الصفحات ومراجعتها، ولماذا الصفحة القديمة أخطر من الصفحة الناقصة.
- الصلاحيات، وكيف يعمل البحث داخل الـ Wiki، ولماذا يصعب بالعربية.
- مختبر على PostgreSQL، وهي قاعدة البيانات التي تبحث بها أغلب أدوات الـ Wiki، نقيس فيه أربع طرق للبحث العربي على 11 صفحة و12 استعلاماً.
- كيف تنقل المعرفة من المحادثة إلى الـ Wiki، وأي أداة تختار، ثم الأخطاء الشائعة وقائمة تحقق.
أين تضيع معرفة الفريق؟ Knowledge Silos
عندما سألنا أنفسنا أين يبحث موظف الدعم في هذا الفريق عن إجراء إضافة مطعم جديد، وجدنا أربعة أماكن، ولكل مكان منها طريقة مختلفة يضيع بها الجواب، وهذا ما تبينه الصورة التالية:

ويسمي الناس هذه الحالة جزر المعرفة Knowledge Silos، أي أن كل جزء من المعرفة يعيش في مكان معزول لا يصل إليه من يحتاجه. ولاحظ أن كل مكان من الأربعة جيد في شيء معين، فالمحادثة سريعة، والمجلد المشترك يحفظ الملفات الكبيرة، وملف README دقيق لأنه بجانب الكود، والشخص الخبير يعرف السياق الذي لا يكتب عادة. ولكن المشكلة أن لا أحد منها صمم ليكون المكان الذي يبحث فيه شخص جديد عن جواب موثوق، فالمحادثة تجيب عن سؤال اليوم، والمجلد يحفظ ملف هذا الأسبوع، والخبير يجيب إذا كان موجوداً وغير مشغول.
وأخطر هذه الأماكن هو رأس الشخص الواحد، لأن الفريق لا يشعر بالمشكلة إلا يوم يغيب هذا الشخص. ويعرف المهندسون هذه الحالة باسم عامل الحافلة Bus Factor، أي عدد الأشخاص الذين إذا غابوا فجأة توقف العمل، فإذا كان الوحيد الذي يعرف كيف تستعاد قاعدة البيانات من النسخة الاحتياطية هو قائد التطوير، فعامل الحافلة لهذا الإجراء واحد، ويكفي أن يكون على متن طائرة وقت العطل لكي تكتشف ذلك. وقد شرحنا في دليل التشغيل Runbook كيف تنقل إجراء العطل من رأس شخص إلى صفحة ينفذها أي مناوب، وفي هذا المقال نكبر الدائرة من إجراءات الأعطال إلى معرفة الفريق كلها.
لماذا لا تكفي المحادثة Chat مكاناً للمعرفة؟
قد يتساءل البعض: لدينا محادثة فيها بحث، وكل رسالة محفوظة، فلماذا نحتاج إلى مكان آخر؟ والإجابة على ذلك أن المحادثة مصممة كجدول زمني Stream، أي أن الرسالة الأحدث في الأعلى والأقدم تنزل وتختفي، بينما المعرفة تحتاج إلى مخزون Stock، أي صفحة واحدة ثابتة تتحدث مع الوقت ولا تنزل تحت غيرها. فعندما يكتب مدير العمليات خطوات إضافة المطعم في رسالة، ثم يصحح الخطوة الثالثة في رد بعد شهرين، ثم يضيف استثناء في قناة أخرى، فالمعرفة الصحيحة أصبحت موزعة على ثلاث رسائل لا يربطها شيء، والباحث يجد الأولى غالباً لأنها الأطول، وهي الخاطئة.
وهناك سبب آخر أقل وضوحاً، وهو أن من يملك السيرفر يقرر كم تبقى الرسائل. ففي 26 أغسطس 2024 بدأت Slack بحذف الرسائل والملفات التي مضى عليها أكثر من سنة من مساحات العمل على الخطة المجانية، فالفريق الذي كانت معرفته في المحادثة فقد جزءاً منها دون أن يقرر ذلك. وحتى إذا نقلت المحادثة إلى سيرفرك كما في دليل تثبيت Mattermost، فالرسائل تبقى ولكن المشكلة الأولى تبقى أيضاً: الرسالة تجيب عن سؤال في لحظته ولا تتحدث بعدها.
لذلك فالقاعدة التي نقترحها على الفريق بسيطة: المحادثة للنقاش والقرار السريع، والـ Wiki للنتيجة. فإذا انتهى نقاش في المحادثة إلى قرار أو إجراء، فمكانه صفحة، والرد الأخير في المحادثة يكون رابطاً لها. وبهذه الطريقة تبقى المحادثة سريعة كما هي، ولكن الجواب الموثوق له عنوان واحد.
ما هي قاعدة المعرفة Wiki، ومن أين جاءت؟
الـ Wiki موقع يستطيع أي شخص مصرح له أن ينشئ فيه صفحة أو يعدلها من المتصفح مباشرة، مع سجل لكل تعديل يمكن الرجوع إليه، وروابط بين الصفحات. وأول Wiki كان موقع WikiWikiWeb الذي أطلقه المبرمج Ward Cunningham سنة 1995 لمجتمع من المبرمجين يتبادلون أنماط التصميم Design Patterns، والكلمة نفسها من لغة هاواي وتعني «سريع». والفكرة التي جعلت هذا النموذج ينجح هي أن تكلفة التعديل قليلة جداً، فمن يجد خطأ في صفحة يصلحه في دقيقة بدلاً من أن يرسل بريداً إلى كاتبها وينتظر.
وقاعدة المعرفة Knowledge Base هي الاستخدام الداخلي لهذه الفكرة داخل مؤسسة: صفحات يكتبها الفريق لنفسه عن إجراءاته وقراراته وأنظمته. ويمكن أن نشبهها بدفتر الوصفات في مطبخ مطعم كبير، فالطاهي الجديد لا يسأل الطاهي القديم عن مقادير كل طبق، وإنما يفتح الدفتر، وإذا تغيرت الوصفة يتغير الدفتر، ويكتب على الصفحة من عدلها ومتى. وأدوات الـ Wiki الحديثة التي نستعرضها في هذه المرحلة، مثل Outline وBookStack وWiki.js وDocmost، تحمل الفكرة نفسها مع محرر مرئي Editor بدلاً من صيغة الكتابة القديمة، وبحث، وصلاحيات، ودخول موحد SSO.
الـ Wiki أم المجلد المشترك Shared Drive أم التوثيق مع الكود Docs as Code؟
قبل أن تختار الـ Wiki يجب أن ترى البدائل الثلاثة التي تستخدمها الفرق فعلاً، لأن كل واحد منها يناسب نوعاً من المحتوى:
- المجلد المشترك Shared Drive: مثل Google Drive أو Nextcloud، وهو مناسب للملفات التي لها شكل نهائي، مثل العقود وملف التسعير المعتمد والعروض التقديمية. ولكنه ضعيف في المعرفة التي تتغير، لأن الملف يعدل خارج المتصفح غالباً، فتظهر النسخ المتعددة، والروابط بين الملفات قليلة، والبحث في كثير من الحالات يبحث في الأسماء أكثر من المحتوى.
- التوثيق مع الكود Docs as Code: ملفات Markdown في مستودع Git، تعدل بطلب دمج Pull Request وتراجع كما يراجع الكود، كما يشرح مجتمع Write the Docs. وهذا أفضل مكان لتوثيق الكود والواجهات البرمجية API، لأن التغيير في الكود والتغيير في توثيقه يمران في الطلب نفسه، ولكن فريق الدعم والمبيعات لن يفتح طلب دمج ليصحح خطوة في إجراء.
- الـ Wiki: التعديل من المتصفح، والبحث في المحتوى، والصلاحيات على مستوى المساحة أو الصفحة، والسجل لكل تعديل، وهو المكان المناسب للمعرفة التي يكتبها ويقرؤها الفريق كله.
والقرار في فريقنا كان كما يلي: توثيق خدمة الطلبات وواجهاتها البرمجية يبقى في المستودع بجانب الكود، والعقود والملفات النهائية تبقى في المجلد المشترك، وكل ما عدا ذلك ينتقل إلى الـ Wiki، مع روابط من الـ Wiki إلى الاثنين بدلاً من نسخ محتواهما. وبعض الأدوات تجمع بين الطريقتين، فـ Wiki.js مثلاً يستطيع أن يحفظ كل صفحة كملف Markdown في مستودع Git، وهذا ما سوف نختبره في مقاله ضمن هذه المرحلة.
أنواع الصفحات: إطار Diátaxis
أول خطأ يقع فيه الفريق عند بناء الـ Wiki هو أن يكتب صفحة واحدة تحاول أن تفعل كل شيء: تشرح النظام وتاريخه، ثم تعطي خطوات الإعداد، ثم جدولاً بالعناوين، ثم رأي الكاتب في البدائل. والنتيجة صفحة طويلة لا يجد فيها المستعجل الخطوة التي يحتاجها، ولا يفهم منها المبتدئ الصورة الكاملة. والحل الذي يستخدمه كثير من فرق التوثيق هو إطار Diátaxis الذي وضعه Daniele Procida، ويقسم الصفحات إلى أربعة أنواع بحسب حاجة القارئ في لحظة القراءة، وهذا ما تبينه الصورة التالية بصفحات من فريقنا:

- الدرس Tutorial: يأخذ القارئ الجديد بيده خطوة بعد خطوة لكي يتعلم، والمهم فيه أن ينجح القارئ في النهاية، مثل «دليل الموظف الجديد في الأسبوع الأول».
- دليل المهمة How-to Guide: خطوات لمهمة يعرف القارئ أنه يريدها الآن، دون شرح طويل، مثل «إجراء إضافة مطعم جديد» و«ربط طابعة الإيصالات بجهاز الكاشير».
- المرجع Reference: حقائق يبحث فيها القارئ ولا يقرؤها من أولها، مثل «قائمة الأنظمة الداخلية ومالك كل نظام» وجدول «مستوى الخدمة SLA».
- الشرح Explanation: لماذا الأمور على ما هي عليه، مثل «قرار: لماذا اخترنا PostgreSQL لخدمة الطلبات».
والفائدة العملية من هذا التقسيم أنك عندما تكتب صفحة تسأل نفسك سؤالاً واحداً: ماذا يفعل القارئ لحظة فتحها؟ فإذا كان موظف الدعم على الهاتف مع مطعم طابعته متوقفة، فهو يحتاج إلى دليل مهمة قصير، وليس إلى شرح لكيفية عمل الطابعات الحرارية، وإذا أردت أن تضيف هذا الشرح فمكانه صفحة أخرى تربط بها. ولا تحتاج إلى أن تكتب اسم النوع في الصفحة، وإنما يكفي أن يعرفه الكاتب وأن يكون لكل نوع قالب، كما سوف نرى بعد قليل.
ثلاثة أنواع لفرق التقنية: ADR، Postmortem، Runbook
وفي الفرق التقنية ثلاثة أنواع من الصفحات تستحق أن يكون لها مكان واضح وقالب ثابت، لأن قيمتها تظهر بعد سنة من كتابتها وليس يوم كتابتها:
- سجل القرار Architecture Decision Record: صفحة قصيرة لكل قرار مهم، فيها الحالة والسياق والقرار والنتائج، كما في صفحة «لماذا اخترنا PostgreSQL». والفائدة أن المهندس الذي ينضم بعد سنتين ويسأل «لماذا لم نبق على MongoDB؟» يجد الجواب مع السياق الذي اتخذ فيه القرار، وقد فصلنا فيه في توثيق المعمارية بمخططات C4 مع ADR.
- مراجعة الحادثة Postmortem: ما حدث، والسبب، والإصلاح، وما تعلمه الفريق، مثل صفحة «تكرار الطلبات في تطبيق الكاشير». والمهم أن تبقى هذه الصفحات في مكان واحد يبحث فيه الفريق قبل أي تغيير مشابه، وقد شرحنا طريقة كتابتها في إدارة الحوادث Incident Response.
- دليل التشغيل Runbook: خطوات تنفيذ تحت الضغط، مثل «استعادة قاعدة البيانات من النسخة الاحتياطية»، وله شرط خاص لا تحتاجه بقية الصفحات، وهو أن يكون متاحاً وقت العطل نفسه، فإذا كانت الـ Wiki على السيرفر الذي تعطل فالدليل تعطل معه.
كيف تقسم المساحات Spaces؟ Information Architecture
كل أدوات الـ Wiki فيها مستوى أعلى يجمع الصفحات، يسمى المساحة Space في Docmost وConfluence، والمجموعة Collection في Outline، والرف Shelf والكتاب Book في BookStack، والمجلد في Wiki.js. والسؤال الذي يتعب الفرق هو على أي أساس تقسم: بحسب الفريق، أم بحسب الموضوع، أم بحسب نوع الصفحة؟ والإجابة التي وصلنا إليها هي أن تقسم بحسب الجهة التي تملك المحتوى وتراجعه، لأن الملكية هي التي تحدد من يحدث الصفحة بعد سنة، أما الموضوع والنوع فتغطيهما الوسوم والبحث. وهذه هي القسمة التي اخترناها لفريقنا:

في التقسيم أعلاه لاحظ التالي:
- عدد المساحات قليل، خمس مساحات لفريق من 14 شخصاً، والسبب أن كل مساحة جديدة سؤال جديد للكاتب «أين أضع هذه الصفحة؟»، وكثرة الخيارات تجعل الناس يضعون الصفحات في أماكن مختلفة للموضوع نفسه.
- العمق قليل، فلا تبعد أي صفحة عن بداية المساحة أكثر من مستويين أو ثلاثة. والشجرة العميقة، مثل «التقنية ثم الخدمات ثم الطلبات ثم قاعدة البيانات ثم النسخ الاحتياطي ثم الاستعادة»، تبدو مرتبة لكاتبها، ولكن الباحث لا يعرف الطريق الذي سلكه الكاتب في ذهنه.
- لكل مساحة مالك واحد بالاسم أو بالدور، وهو المسؤول عن ترتيبها ومراجعتها، وليس بالضرورة كاتب كل صفحاتها.
عنوان الصفحة Title بكلمات الباحث
العنوان أهم سطر في الصفحة، لأن أغلب أدوات البحث تعطي الكلمة في العنوان وزناً أكبر من الكلمة في المحتوى، ولأن العنوان هو ما يظهر في قائمة النتائج وفي الروابط. لذلك اكتب العنوان بالكلمات التي سوف يكتبها الباحث، وليس بالكلمات التي يستخدمها الفريق الذي بنى النظام. ففريق التطوير يسمي الطابعة «جهاز الطباعة الحرارية المتصل بالمنفذ 9100»، أما موظف الدعم فيكتب في البحث «طابعة» أو «الإيصال لا يطبع». ولذلك كان عنوان الصفحة «ربط طابعة الإيصالات بجهاز الكاشير»، وإذا كان هناك اسم آخر يستخدمه الناس فاكتبه في السطر الأول من الصفحة لكي يجده البحث.
والقاعدة الثانية أن يبدأ عنوان دليل المهمة بالفعل أو الاسم الذي يصف المهمة، مثل «إجراء إضافة مطعم جديد» و«استعادة قاعدة البيانات PostgreSQL»، وأن يبدأ عنوان القرار بكلمة «قرار:»، وعنوان مراجعة الحادثة بعبارة «مراجعة حادثة:». فالقارئ يعرف من العنوان وحده نوع الصفحة قبل أن يفتحها، والبحث عن «قرار» يعرض كل القرارات.
القوالب Templates تجعل الصفحات متشابهة
القالب صفحة جاهزة فيها العناوين الفرعية لنوع معين، ينسخها الكاتب ويملؤها. وأغلب أدوات الـ Wiki تدعم القوالب بشكل مباشر، وإذا لم تدعمها فصفحة «قوالب» تنسخ منها تكفي. وفائدة القالب ليست الشكل فقط، وإنما أنه يذكر الكاتب بما ينساه عادة، فقالب دليل المهمة في فريقنا فيه السطر «متى تستخدم هذا الإجراء؟» وسطر «ماذا تفعل إذا فشلت الخطوة؟»، وقالب القرار فيه «ما البدائل التي رفضناها ولماذا؟»، وهو السطر الذي يحتاجه القارئ بعد سنتين أكثر من غيره. وهذا مثال لقالب دليل المهمة كما استخدمناه:
# [المهمة بكلمات الباحث]
المالك: [الاسم أو الدور] · آخر مراجعة: [التاريخ] · المراجعة القادمة: [التاريخ]
## متى تستخدم هذا الإجراء؟
## قبل أن تبدأ
## الخطوات
1. ...
## كيف تعرف أنك نجحت؟
## ماذا تفعل إذا فشلت خطوة؟
## صفحات مرتبطةولاحظ السطر الثاني في القالب، فهو الذي يجعل الصفحة قابلة للمراجعة، وسوف نعود إليه في قسم الملكية.
الوسوم Tags، ثم الروابط Links بين الصفحات
المساحة تجيب عن سؤال «من يملك هذه الصفحة؟»، أما الوسوم فتجيب عن سؤال «عن ماذا تتكلم؟»، والصفحة الواحدة يمكن أن تحمل أكثر من وسم. ففي فريقنا صفحة «ربط طابعة الإيصالات» في مساحة الدعم، ولكنها تحمل الوسم «طابعة»، وكذلك صفحة «مستوى الخدمة» لأن فيها سطراً عن توقف الطابعة. وقد وجدنا في مقال BookStack أن البحث بالوسم دقيق ولا يتأثر بشكل الكلمة، بينما البحث في النص يتأثر كثيراً كما سوف نرى في المختبر. والروابط بين الصفحات أهم من الوسوم، فكل دليل مهمة يربط بالشرح الذي يحتاجه، وكل قرار يربط بالحادثة التي سببته إن وجدت، ودليل الموظف الجديد هو في الحقيقة قائمة روابط مرتبة. والأداة التي تعرض الروابط العكسية Backlinks، أي الصفحات التي تشير إلى الصفحة الحالية، تساعدك على معرفة أثر أي تعديل قبل أن تفعله.
لكل صفحة مالك Owner مع تاريخ مراجعة Review Date
هنا تنجح قاعدة المعرفة أو تفشل. فالصفحات لا تفسد في يوم واحد، وإنما يتغير النظام قليلاً، ثم يتغير مرة أخرى، ولا يتذكر أحد أن هناك صفحة تشرحه، فتبقى الصفحة كما هي وتبدأ بإعطاء معلومات خاطئة بثقة كاملة. والحل الذي تستخدمه الفرق التي نجحت في هذا هو أن يكون لكل صفحة مالك بالاسم أو بالدور، وتاريخ آخر مراجعة مكتوب في أعلاها، وتاريخ المراجعة القادمة، والصورة التالية تبين الدورة كاملة:

والمالك ليس من يكتب كل شيء، وإنما من يجيب عن سؤال «هل هذه الصفحة صحيحة اليوم؟»، فأي شخص في الفريق يستطيع أن يصلح خطأ يراه، ولكن المالك هو الذي يراجع الصفحة كاملة في موعدها. ومدة المراجعة تختلف بحسب النوع، فدليل المهمة الذي يعتمد على نظام يتغير كل شهر يحتاج إلى مراجعة كل ثلاثة أشهر، أما سجل القرار فلا يراجع لأنه يسجل ما حدث في وقته، وإذا تغير القرار تكتب صفحة قرار جديدة تشير إلى القديمة بأنها استبدلت. وبعض الأدوات تساعد في هذا، فقد أضاف Wiki.js في الإصدار 3.0 قواعد دورة حياة Lifecycle Rules تعرض تنبيهاً على الصفحة التي لم تحدث منذ ثلاثة أشهر وتنبه مالكها، وفي الأدوات التي لا تدعم ذلك يكفي تقرير شهري بالصفحات الأقدم.
الصفحة القديمة Stale Page أخطر من الصفحة الناقصة
الموظف الذي لا يجد صفحة يسأل زميله، فيحصل على الجواب الصحيح ويعرف أن هناك صفحة ناقصة. أما الموظف الذي يجد صفحة قديمة فيتبعها بثقة، فيرسل الفاتورة قبل تأكيد بيانات الفرع، أو يدخل إلى سيرفر لم يعد موجوداً، ولا يعرف أنه أخطأ إلا بعد أن تظهر المشكلة عند العميل. ولهذا يقول دليل التوثيق في Google إن مجموعة صغيرة من الوثائق الحديثة الدقيقة أفضل من مجموعة كبيرة من «الوثائق» بحالات مختلفة من الإهمال، ويطلب حذف التوثيق الميت Dead Documentation، ويقترح عند النقل إلى نظام جديد أن يكون الحذف أو الترك هو الخيار الافتراضي، لأن ما تحتاجه فعلاً يمكن استرجاعه لاحقاً.
لذلك عندما نقل فريقنا المعرفة إلى الـ Wiki لم ينقل كل ملفات المجلد المشترك، وإنما بدأ بقائمة الأسئلة التي تتكرر في المحادثة، وكتب لكل سؤال صفحة، ثم نقل من المجلد ما تحتاجه هذه الصفحات فقط. وبقي في المجلد القديم ما لم ينقل، مع ملف في أعلاه يقول إن المعرفة الحالية في الـ Wiki وإن هذا المجلد أرشيف لا يحدث.
الصلاحيات Permissions: مفتوح افتراضياً ومغلق بسبب
عندما يبني الفريق أول Wiki يميل إلى أن يغلق كل شيء، فمساحة التقنية للمطورين فقط، ومساحة المبيعات للمبيعات فقط، والسبب الذي يقال عادة هو «حتى لا يعدل أحد ما لا يعرفه». والنتيجة أن موظف الدعم لا يجد صفحة «الدخول إلى السيرفرات» التي يحتاجها ليعرف لمن يرسل البلاغ، ومهندس التطوير لا يرى قواعد الخصومات التي يبرمجها في الفاتورة، فيعود الجميع إلى السؤال في المحادثة. والقاعدة التي نقترحها هي أن القراءة مفتوحة لكل الموظفين افتراضياً، وأن الإغلاق يكون بسبب واضح يكتب، مثل بيانات الموظفين في مساحة الموارد البشرية، أو أسرار لا يجب أن تكون في الـ Wiki أصلاً.
أما التعديل فالأمر فيه مختلف قليلاً. فإذا كانت ثقافة الفريق تسمح بأن يصلح أي شخص خطأ يراه، فاجعل التعديل مفتوحاً أيضاً، لأن السجل يحفظ كل تعديل ويمكن الرجوع عنه. وإذا كانت بعض الصفحات حساسة، مثل سياسة الإجازات أو قواعد الخصومات، فاجعل تعديلها لمالكها فقط، واترك الباقي مفتوحاً. ولاحظ أن الأدوات تختلف في طريقة الصلاحيات، فبعضها على مستوى المساحة فقط، وبعضها يصل إلى الصفحة الواحدة، وBookStack مثلاً يخفي الكتاب المقيد بالكامل حتى لا يعرف المستخدم أنه موجود، كما رأينا في قسم الصلاحيات في مقاله.
كيف يعمل البحث Search داخل الـ Wiki؟
الـ Wiki التي لا يجد فيها الناس ما يبحثون عنه في أول محاولة تخسر ثقتهم بسرعة، فالموظف الذي بحث مرتين عن «الطابعة» ولم يجد شيئاً يعود إلى المحادثة ولا يجرب البحث مرة ثالثة. لذلك يجب أن تعرف كيف يعمل البحث في الأداة التي تختارها، وليس فقط أن فيها مربع بحث. والفكرة الأساسية شرحناها بالتفصيل في كيف يعمل البحث: الفهرس المعكوس والترتيب، وخلاصتها أن الأداة لا تقرأ كل الصفحات عند كل بحث، وإنما تبني مسبقاً فهرساً معكوساً Inverted Index، وهو جدول يقابل كل كلمة بالصفحات التي فيها، مثل الفهرس في آخر الكتاب. والصورة التالية تبين ما يحدث للنص قبل أن يدخل الفهرس:

فالنص يقسم إلى كلمات Tokenization، ثم توحد أشكال الكلمة Normalization، مثل تحويل الحروف الإنجليزية إلى صغيرة، ثم ترد الكلمة إلى جذع Stem تشترك فيه أشكالها المختلفة، مثل «للسيرفرات» و«السيرفرات» إلى «سيرفر». والاستعلام الذي يكتبه الباحث يمر بالخطوات نفسها، ثم يبحث عنه في الفهرس. والنقطة التي يجب أن تتذكرها من هذه الصورة هي أن المطابقة تحدث على الكلمة بعد المعالجة، وليس على ما كتبه الشخص، فإذا عالجت الأداة كلمة النص بطريقة وكلمة الاستعلام بطريقة أخرى، فلن تلتقيا ولو كانت الكلمة نفسها.
وهذا مهم لنا لأن أغلب أدوات الـ Wiki مفتوحة المصدر لا تشغل محرك بحث منفصلاً مثل OpenSearch، وإنما تستخدم البحث النصي الكامل Full Text Search المبني في قاعدة البيانات، فـ Outline وDocmost وWiki.js كلها تعمل على PostgreSQL، وBookStack يبني فهرسه الخاص في MySQL أو MariaDB. لذلك فأفضل طريقة لنفهم ماذا ينتظر البحث العربي في هذه الأدوات هي أن نختبر PostgreSQL نفسه، وهذا ما سوف نفعله في المختبر بعد أن نرى لماذا العربية صعبة أصلاً.
لماذا يصعب البحث بالعربية؟ Arabic Search
الكلمة العربية الواحدة تظهر في النص بأشكال كثيرة، وقد عددناها بالتفصيل في البحث في النصوص العربية مع OpenSearch وMeilisearch، وما يهمنا منها في قاعدة معرفة الفريق خمسة أشياء رأيناها كلها في صفحات فريقنا:
- الحروف الملتصقة بالكلمة Clitics: «ال» و«و» و«ب» و«ل» و«ف» تلتصق بأول الكلمة، فالسيرفر يظهر في النص بالأشكال «السيرفر» و«للسيرفرات» و«بالسيرفر»، والباحث يكتب «سيرفر».
- الهمزات والحروف المتشابهة: «إجراء» و«اجراء»، و«الفاتورة» و«الفاتوره»، و«مستوى» و«مستوي»، فكثير من الناس يكتبون في البحث دون همزة، ولوحات المفاتيح في الجوال تجعل الهاء أقرب من التاء المربوطة.
- الجمع Plural: جمع المؤنث السالم مثل «طابعة» و«طابعات» يتغير آخره فقط، أما الجمع الذي يتغير فيه شكل الكلمة Broken Plural مثل «مطعم» و«مطاعم» فيتغير شكل الكلمة من داخلها، ولا يكفي أن تحذف آخرها لكي يلتقي المفرد مع الجمع.
- الكلمات الإنجليزية داخل النص العربي: «PostgreSQL» و«WireGuard» و«SLA»، والباحث يكتب «postgres» بحروف صغيرة أو يكتب «بوستجرس» بالعربية.
- التشكيل والتطويل: قليلة في التوثيق التقني، ولكنها تظهر عند النسخ من مستندات رسمية، و«مـدير» بالتطويل كلمة مختلفة عند الآلة عن «مدير».
والسؤال العملي: هل تعالج أداة البحث هذه الأشكال، أم تطابق الحروف كما هي؟ والإجابة تختلف من أداة إلى أخرى، ولذلك بنينا اختباراً واحداً بصفحات فريقنا نعيد استخدامه في كل مقالات المرحلة.
المختبر Lab: البحث العربي في PostgreSQL
الهدف من هذا المختبر هو أن نرى بأعيننا ماذا يفعل PostgreSQL بالكلمات العربية في البحث النصي الكامل، وأن نقيس أربع طرق للبحث على المحتوى نفسه. وكل ما تحتاجه هو Docker وPython، والملفات كلها في مجلد lab مع المقال.
التجهيز Setup: 11 صفحة و12 استعلاماً
كتبنا 11 صفحة قصيرة بالعربية من قاعدة معرفة فريقنا في الملف pages.json، وهي الصفحات التي ظهرت في صورة المساحات أعلاه، من «إجراء إضافة مطعم جديد» إلى «أسعار الباقات والخصومات». ثم كتبنا في الملف queries.json اثني عشر استعلاماً، ولكل استعلام الصفحة أو الصفحات التي يجب أن يجدها، واخترنا الاستعلامات بحيث يختبر كل واحد منها شكلاً من أشكال الكلمة التي ذكرناها، مثل «اجراء» دون همزة والنص فيه «إجراء»، و«الفاتوره» بالهاء، و«سيرفر» والنص فيه «السيرفرات» و«للسيرفرات»، و«postgres» والنص فيه «PostgreSQL». ثم شغلنا PostgreSQL 18.6:
docker run -d --name wr-kb-pg -e POSTGRES_PASSWORD=lab postgres:18.6-alpine
docker exec wr-kb-pg psql -U postgres -Atc "select cfgname from pg_ts_config order by 1"والأمر الثاني يعرض إعدادات البحث النصي Text Search Configurations الموجودة، والمخرج سوف يكون كما يلي:
arabic armenian basque catalan danish dutch english estonian finnish french german greek hindi hungarian indonesian irish italian lithuanian nepali norwegian portuguese romanian russian serbian simple spanish swedish tamil turkish yiddishلاحظ أن الإعداد arabic موجود في PostgreSQL دون أي إضافة، وهو يستخدم محلل Snowball العربي لرد الكلمات إلى جذوعها، بينما الإعداد simple يحول الحروف إلى صغيرة فقط ولا يغير الكلمة. والسؤال المهم الذي يجب أن تسأله عن أي أداة Wiki على PostgreSQL هو أي إعداد تستخدم، لأن كثيراً منها يستخدم simple أو english لكل اللغات.
بعد ذلك يحول السكربت make-sql.py الصفحات إلى جدول، ويبني لكل استعلام أربعة شروط بحث، وهذا الجزء المهم منه:
CREATE OR REPLACE FUNCTION ar_norm(t text) RETURNS text IMMUTABLE LANGUAGE sql AS
$$ SELECT translate(lower(t), 'أإآٱةىـ', 'اااايه') $$;
m = {
'1-simple': f"to_tsvector('simple', title||' '||body) @@ plainto_tsquery('simple', {s})",
'2-arabic': f"to_tsvector('arabic', title||' '||body) @@ plainto_tsquery('arabic', {s})",
'3-arabic+norm': f"to_tsvector('arabic', ar_norm(title||' '||body)) @@ plainto_tsquery('arabic', ar_norm({s}))",
'4-trigram': f"word_similarity(ar_norm({s}), ar_norm(title||' '||body)) >= 0.6",
}في الكود أعلاه لاحظ التالي:
- الدالة
ar_normهي محاولتنا لتوحيد الحروف: تحول أشكال الألف بالهمزة إلى ألف، والتاء المربوطة إلى هاء، والألف المقصورة إلى ياء، وتحذف التطويل. وسوف نرى أن هذه المحاولة كان فيها خطأ. to_tsvectorتحول النص إلى قائمة جذوع، وplainto_tsqueryتحول الاستعلام إلى جذوع بالإعداد نفسه، والعلامة@@تعني «هل يطابق؟».- الطريقة الرابعة لا تستخدم الجذوع أصلاً، وإنما إضافة pg_trgm التي تقطع الكلمة إلى مقاطع من ثلاثة حروف Trigrams وتقيس نسبة المقاطع المشتركة، و
word_similarityتعطي رقماً بين 0 و1 لأقرب جزء في النص إلى الاستعلام.
ماذا يفعل المحلل بكل كلمة؟ Text Search Configuration
قبل أن نشغل الاستعلامات نرى ماذا يفعل كل إعداد بكلمات من النص ومن الاستعلامات، وهذه هي الطريقة الصحيحة لفهم أي بحث، أي أن تنظر إلى ما دخل الفهرس فعلاً:
docker exec wr-kb-pg psql -U postgres -c "select w, to_tsvector('simple',w) s, to_tsvector('arabic',w) a,
to_tsvector('arabic',ar_norm(w)) an from unnest(array['إجراء','اجراء','الفاتورة','الفاتوره','السيرفرات',
'للسيرفرات','سيرفر','طابعات','طابعة','مستوى','مستوي']) w"والمخرج سوف يكون كما يلي:
w | s | a | an
-----------+---------------+------------+------------
إجراء | 'إجراء':1 | 'اجراء':1 | 'اجراء':1
اجراء | 'اجراء':1 | 'اجراء':1 | 'اجراء':1
الفاتورة | 'الفاتورة':1 | 'فاتور':1 | 'فاتور':1
الفاتوره | 'الفاتوره':1 | 'فاتوره':1 | 'فاتوره':1
السيرفرات | 'السيرفرات':1 | 'سيرفر':1 | 'سيرفر':1
للسيرفرات | 'للسيرفرات':1 | 'سيرفر':1 | 'سيرفر':1
سيرفر | 'سيرفر':1 | 'يرفر':1 | 'يرفر':1
طابعات | 'طابعات':1 | 'طابعا':1 | 'طابعا':1
طابعة | 'طابعة':1 | 'طابع':1 | 'طابع':1
مستوى | 'مستوى':1 | 'مستوي':1 | 'مست':1
مستوي | 'مستوي':1 | 'مستو':1 | 'مستو':1ولنقرأ الأعمدة واحداً واحداً، لأن كل سطر هنا يفسر نتيجة سوف نراها بعد قليل:
- العمود
sللإعدادsimple: الكلمة كما هي، فـ «إجراء» و«اجراء» كلمتان مختلفتان، و«السيرفرات» لا تلتقي مع «سيرفر» أبداً، وهذا ما تفعله الأداة التي تطابق الحروف. - العمود
aللإعدادarabic: المحلل وحد الهمزة، فأصبحت «إجراء» و«اجراء» الجذع نفسهاجراء، وحذف «ال» و«لل» من أول الكلمة، فأصبحت «السيرفرات» و«للسيرفرات»سيرفر، وحذف التاء المربوطة من آخر «الفاتورة» و«طابعة». - ولكن «سيرفر» وحدها أصبحت
يرفر، والسبب أن المحلل عنده قاعدة للأفعال تحول البداية «سي» إلى «ي»، كما في «سيكتب» التي تصبح «يكتب»، وعندما جاءت الكلمة دون «ال» لم يعرف أنها اسم، فعاملها كفعل مضارع مع حرف الاستقبال. أما «السيرفرات» فبدايتها «ال» التي تخبره أنها اسم، فلم يطبق القاعدة. وبالتالي فالنص في الفهرسسيرفر، والاستعلاميرفر، ولن يلتقيا. - «الفاتوره» بالهاء بقيت
فاتوره، لأن المحلل يحذف التاء المربوطة ولا يعرف أن الهاء هنا كتبت مكانها، و«طابعات» أصبحتطابعاو«طابعة» أصبحتطابع، فالجمع والمفرد لم يلتقيا أيضاً.
النتائج Results: أربع طرق على الاستعلامات نفسها
الآن نشغل الاستعلامات الاثني عشر بالطرق الأربع، ونطبع لكل استعلام الصفحات التي وجدها:
python make-sql.py
docker cp seed.sql wr-kb-pg:/seed.sql && docker cp queries.sql wr-kb-pg:/queries.sql
docker exec wr-kb-pg psql -U postgres -q -f /seed.sql
docker exec wr-kb-pg psql -U postgres -q -f /queries.sqlوالمخرج سوف يكون كما يلي، بعد أن حذفنا منه عمودين نعود إليهما في تجربة «ماذا لو»:
q | simple | arabic | arabic_norm | trigram
---------------+---------+---------+-------------+-------------
إجراء | p01,p07 | p01,p07 | p01,p07 | p01,p07
اجراء | - | p01,p07 | p01,p07 | p01,p07
الفاتوره | - | - | - | p01,p06,p11
سيرفر | - | - | - | p01,p05
طابعة | p02 | p02,p09 | p02,p09 | p02,p09
مستوي | - | - | - | p09
الإجازات | p04 | p04 | p04 | p04
الاسترجاع | p03 | p03 | p03 | p03
wireguard | p05 | p05 | p05 | p05
postgres | - | - | - | p03,p06
تكرار الطلبات | p08 | p08 | p08 | p06,p08
الموظف الجديد | p07 | p07 | p07 | p07ثم يقارن السكربت score.py كل سطر بالصفحات المتوقعة في queries.json، ويعد الاستعلامات التي وجدت صفحتها، والصفحات الإضافية التي جاءت خارج المتوقع، والصورة التالية تلخص ذلك:

والنتائج تقول ما يلي:
- التطابق الحرفي وجد 7 من 12: وجد كل استعلام كتب كما في النص، مثل «الإجازات» لأن النص فيه هذه الكلمة نفسها، وفشل في كل استعلام اختلف فيه حرف واحد، مثل «اجراء» دون همزة.
- المحلل العربي وجد 8 من 12: أضاف «اجراء» لأنه وحد الهمزة، ولكنه فشل في أربعة: «الفاتوره» و«سيرفر» و«مستوي» لأسباب رأيناها في الجدول السابق، و«postgres» لأن PostgreSQL كلمة واحدة في الفهرس ولا يبحث المحلل في جزء من الكلمة. والصفحات الإضافية الثلاث ليست أخطاء كلها، فصفحة «دليل الموظف الجديد» فيها «اقرأ إجراء إضافة مطعم جديد»، وصفحة «مستوى الخدمة» فيها «توقف الطابعة في فرع»، وكلاهما نتيجة يقبلها الباحث.
- الحروف الثلاثية وجدت 12 من 12: لأنها لا تهتم بالجذع، وإنما بنسبة المقاطع المشتركة، فـ «سيرفر» تشترك مع «السيرفرات» في أغلب مقاطعها، وكان رقم التشابه مع صفحة VPN هو 0.667 فتجاوز الحد 0.6. والثمن خمس صفحات إضافية، منها صفحة القرار في استعلام «تكرار الطلبات» لأنها تذكر «خدمة الطلبات».
المشكلة التي ظهرت: توحيد الحروف Normalization أفسد كلمة
كنا نتوقع أن تكون الطريقة الثالثة، أي المحلل العربي بعد دالتنا ar_norm، أفضل من المحلل وحده، لأنها توحد التاء المربوطة مع الهاء والألف المقصورة مع الياء قبل التحليل، وبالتالي يلتقي «الفاتوره» مع «الفاتورة» و«مستوي» مع «مستوى». ولكن النتيجة كانت 8 من 12 مثل المحلل وحده تماماً، وعندما نظرنا إلى العمود an في جدول الكلمات وجدنا السبب: «مستوى» بعد دالتنا أصبحت «مستوي» ثم حذف المحلل الياء الأخيرة لأنه ظنها ياء المتكلم كما في «كتابي»، فأصبح الجذع مست، وكذلك «الفاتورة» أصبحت «الفاتوره» فلم يعد المحلل يحذف آخرها لأنه يحذف التاء المربوطة ولا يحذف هذه الهاء. أي أن توحيدنا للحروف أخذ من المحلل العلامة التي كان يعتمد عليها.
والدرس هنا أكبر من هذا المثال: التوحيد والتجذيع خطوتان مرتبطتان، وأي تغيير في إحداهما يجب أن يختبر مع الأخرى على كلمات حقيقية من محتواك، ولا يكفي أن تبدو القاعدة منطقية. ولو نشرنا هذه الدالة في Wiki حقيقية لكانت نتائج البحث أسوأ في بعض الكلمات دون أن يلاحظ أحد، لأن المستخدم الذي لا يجد صفحة لا يرفع بلاغاً، وإنما يتوقف عن البحث. لذلك فالجدول الذي فيه ما دخل الفهرس لكل كلمة هو أول ما تنظر إليه قبل أي تعديل في إعدادات البحث.
ماذا لو غيرنا حد التشابه Threshold؟ What If
الطريقة الرابعة وجدت كل الصفحات عند الحد 0.6، فماذا لو خففنا الحد لنضمن ألا يفوتنا شيء، أو شددناه لنقلل الصفحات الإضافية؟ أضفنا إلى السكربت الحدين 0.3 و0.8، وهذا ما أعاده score.py للطرق الست:
simple found 7/12 extra 1
arabic found 8/12 extra 3
arabic_norm found 8/12 extra 3
trigram found 12/12 extra 5
trgm_03 found 12/12 extra 40
trgm_08 found 9/12 extra 2عند الحد 0.3 بقيت النتيجة 12 من 12، ولكن الصفحات الإضافية ارتفعت من 5 إلى 40، فاستعلام «الإجازات» وحده أعاد الصفحات الإحدى عشرة كلها، لأن أي كلمة فيها «ات» أو «ال» تشترك معه في مقطع أو اثنين، وكذلك «الاسترجاع». وهذه نتيجة أسوأ من عدم وجود نتيجة، لأن الصفحة المطلوبة موجودة ولكنها بين إحدى عشرة صفحة. وعند الحد 0.8 انخفضت النتيجة إلى 9 من 12، ففاتتنا «الفاتوره» و«سيرفر» و«مستوي»، وهي الاستعلامات نفسها التي احتجنا الحروف الثلاثية من أجلها. فالحد ليس رقماً تضبطه مرة وتنساه، وإنما مفاضلة بين ألا يفوتك شيء وبين ألا يغرق الباحث في نتائج كثيرة، وهما ما يسمى الاستدعاء Recall والدقة Precision، وقد شرحنا قياسهما في مقال البحث.
ماذا تعني النتائج لفريقك؟ Lessons
هذا المختبر ليس لكي تكتب محرك بحث بنفسك، وإنما لكي تعرف الأسئلة التي تسألها عن أي أداة Wiki قبل أن تختارها، وما تعلمه لفريقك بعد أن تختارها:
- اسأل عن إعداد البحث: هل الأداة تستخدم المحلل العربي، أم
simple، أمenglishلكل النصوص، وهل فيها بحث بالحروف الثلاثية أو بجزء من الكلمة؟ وسوف نجيب عن هذا السؤال لكل أداة بالقياس نفسه في مقال المقارنة. - اختبر بكلماتك أنت، فالصفحات الإحدى عشرة والاستعلامات الاثنا عشر في مجلد المختبر تصلح بداية، ولكن الأفضل أن تجمع من المحادثة عشرين سؤالاً حقيقياً سأله فريقك، وتكتب لكل سؤال الصفحة التي يجب أن يجدها.
- علم الفريق عادة بسيطة في الأدوات التي تطابق الحروف: ابحث بالكلمة كما تكتب في النص غالباً، مع «ال» ومع الهمزة، وإذا لم تجد فجرب جزءاً من أول الكلمة.
- اكتب الصفحة لكي يجدها البحث: في السطر الأول الكلمات البديلة التي يستخدمها الناس، مثل «طابعة الإيصالات (الطابعة الحرارية، طابعة الفواتير)»، وفي العنوان الكلمة الأشهر.
كيف تنقل المعرفة من المحادثة إلى الـ Wiki؟ Migration Habits
الأداة الجيدة وحدها لا تصنع قاعدة معرفة، والفرق التي تنجح في هذا تنجح بعادات يومية صغيرة أكثر من مشروع نقل كبير. وتلخص صفحة Handbook First في دليل GitLab الفكرة في جملة واحدة: كل جواب أو حل غير موثق يجب أن يوثق فوراً، وتذكر أن الهدف ليس أن يكتمل الدليل قبل الإعلان عنه، وأن الأجوبة الموثقة يقرؤها الموظفون الجدد حتى بعد أن يغادر من كتبها. وهذه العادات التي اتفق عليها فريقنا:
- قاعدة المرة الثانية: إذا سئل السؤال نفسه مرتين، فالجواب في المرة الثانية يكون صفحة، والرد في المحادثة رابطها. وهذه القاعدة وحدها أنتجت في الشهر الأول أغلب الصفحات التي يحتاجها الفريق فعلاً، لأنها تكتب ما يسأل عنه الناس وليس ما يظن الكاتب أنهم يحتاجونه.
- الجواب برابط: عندما يسأل أحد في المحادثة عن شيء له صفحة، يكون الرد رابط الصفحة وليس الجواب نفسه، حتى لو كان الجواب سطراً واحداً. وهذا يبدو قاسياً في البداية، ولكنه يعلم الفريق أين يبحث، ويجعل كل خطأ في الصفحة يظهر بسرعة لأن الكل يقرؤها.
- قناة للتوثيق: قناة في المحادثة يكتب فيها من لم يجد صفحة، أو وجد صفحة خاطئة، وصاحب المساحة يرد بالإصلاح. والسطر الأخير في دليل الموظف الجديد يطلب منه أن يكتب هنا كل سؤال لم يجد جوابه، لأن الموظف الجديد يرى الثغرات التي لا يراها من تعود على الأمور.
- نصف ساعة أسبوعياً للمراجعة: كل مالك مساحة يراجع الصفحات التي وصل موعد مراجعتها، ويغلق ما وصل إلى قناة التوثيق. ويسمي بعض الناس هذا العمل البستنة Gardening، لأن الـ Wiki مثل الحديقة، إذا تركتها شهرين لا تموت ولكن يصعب دخولها.
- البداية بالأسئلة لا بالملفات: كما ذكرنا في قسم الصفحة القديمة، لا تنقل المجلد المشترك كاملاً، وإنما ابدأ بأكثر عشرين سؤالاً تكراراً، وانقل ما تحتاجه صفحاتها.
أي أداة تختار؟ Wiki Tools
الأدوات مفتوحة المصدر التي يمكن أن تشغلها على سيرفرك كثيرة، وقد عرضنا موقعها بين بقية البدائل في خريطة البدائل. وفي هذه المرحلة نختبر أشهرها على صفحات فريقنا نفسها، ويختلف كل واحد منها في طريقة التنظيم أكثر من أي شيء آخر:
- Outline: مجموعات Collections ومستندات متداخلة بمحرر سريع وكتابة مشتركة في الوقت نفسه، ويحتاج إلى مزود دخول مثل authentik، وقد شرحنا تثبيته في Outline: قاعدة معرفة فريقك على سيرفرك.
- BookStack: أرفف وكتب وفصول وصفحات بشكل ثابت، مع صلاحيات تصل إلى الصفحة الواحدة، وقد اختبرنا فيه البحث بالعربية والاتجاه من اليمين إلى اليسار في BookStack: توثيق فريقك في كتب وفصول.
- Wiki.js: صفحات بصيغة Markdown مع مزامنة إلى مستودع Git، وقد صدر منه الإصدار 3.0 في نوفمبر 2026 بعد إعادة كتابة كاملة.
- Docmost: مساحات وصفحات بمحرر قريب من Notion وConfluence، مع كتابة مشتركة وتعليقات.
- HedgeDoc: ليس Wiki كاملة، وإنما محرر Markdown يكتب فيه عدة أشخاص في الوقت نفسه، ويناسب محاضر الاجتماعات والمسودات قبل أن تنتقل إلى الـ Wiki.
وقبل أن تقرأ مقالات الأدوات، اكتب على ورقة إجاباتك عن ثلاثة أسئلة، لأنها هي التي تحدد الأداة أكثر من قائمة الميزات: هل يكتب الفريق كله أم أشخاص قليلون؟ وهل تحتاج إلى صلاحيات على صفحات معينة أم يكفي مستوى المساحة؟ وهل تريد المحتوى في Git لكي يراجع كما يراجع الكود؟ ثم نقارن الأدوات الأربع على المحتوى نفسه في مقال المقارنة، بالبحث العربي والذاكرة RAM ووقت الإعداد والصلاحيات والتصدير.
أخطاء شائعة Common Mistakes
- البدء بالأداة قبل العادة: الفريق يقضي أسبوعين في المقارنة والتثبيت، ثم لا يكتب أحد، لأن أحداً لم يتفق على قاعدة المرة الثانية ولا على مالك لكل مساحة.
- نقل المجلد المشترك كاملاً: مئات الملفات القديمة تدخل الـ Wiki في يوم واحد، فتملأ نتائج البحث وتخفي الصفحات الحديثة، ويفقد الفريق الثقة من الأسبوع الأول.
- شجرة عميقة: ست مستويات من المجلدات تبدو مرتبة، ولكن لا أحد غير كاتبها يعرف الطريق إلى الصفحة.
- إغلاق كل شيء: كل مساحة لفريقها فقط، فيعود الناس إلى السؤال في المحادثة لأنهم لا يرون الجواب.
- صفحات دون مالك ولا تاريخ: لا يعرف القارئ هل كتبت الصفحة الشهر الماضي أم قبل ثلاث سنوات.
- الثقة بالبحث دون اختبار: افتراض أن البحث يعمل بالعربية لأنه يعمل بالإنجليزية، وقد رأينا في المختبر أن حرفاً واحداً يغير النتيجة.
- الأسرار في الصفحات: كلمة مرور في صفحة «الدخول إلى السيرفرات» تبقى في السجل بعد حذفها.
- دليل العطل على السيرفر المعطل: صفحة «استعادة قاعدة البيانات» على Wiki تعمل على قاعدة البيانات نفسها، فلا تفتح يوم تحتاجها.
قائمة تحقق Checklist لقاعدة المعرفة
| البند | كيف تتحقق منه |
|---|---|
| المساحات قليلة وبحسب المالك | كل مساحة لها مالك بالاسم أو الدور، وعددها أقل من 10 لفريق صغير |
| العمق قليل | أي صفحة على بعد ثلاث نقرات على الأكثر من بداية مساحتها |
| لكل نوع صفحة قالب | دليل المهمة، والمرجع، والقرار، ومراجعة الحادثة، ودليل التشغيل |
| العنوان بكلمات الباحث | اسأل موظفاً من فريق آخر ماذا يكتب في البحث، وقارن بالعنوان |
| في أعلى كل صفحة مالك وتاريخ مراجعة | تقرير شهري بالصفحات التي تجاوزت موعدها |
| القراءة مفتوحة افتراضياً | كل مساحة مقيدة لها سبب مكتوب |
| لا توجد أسرار في الصفحات | بحث دوري عن كلمات مثل password وtoken وkey |
| البحث العربي مختبر | عشرون سؤالاً حقيقياً من المحادثة، ولكل سؤال صفحته المتوقعة |
| المحادثة تشير إلى الـ Wiki | قاعدة المرة الثانية، وقناة للتوثيق |
| أدلة الأعطال متاحة وقت العطل | نسخة خارج السيرفر الذي تعمل عليه الـ Wiki |
| الـ Wiki نفسها لها نسخة احتياطية | استعادة مختبرة كما في قاعدة 3-2-1 |
تدريب عملي Practice
- اجمع من محادثة فريقك عشرين سؤالاً تكرر أكثر من مرة في الأشهر الثلاثة الماضية، وصنفها بأنواع Diátaxis الأربعة، ثم اكتب لأكثر خمسة منها تكراراً صفحات بالقالب أعلاه.
- أضف إلى ملف
queries.jsonفي المختبر خمسة استعلامات من كلمات فريقك، مثل اسم منتج بالعربية وبالإنجليزية، وجمعاً يتغير فيه شكل الكلمة مثل «مطاعم»، وشغل السكربت، ثم انظر في جدول الكلمات لكل استعلام فشل وفسر السبب.
حذف المختبر Cleanup
docker rm -f wr-kb-pg
docker rmi postgres:18.6-alpine # إذا لم تكن تحتاجها لمختبر آخرمقالات المرحلة Related Posts
هذا المقال هو بداية مرحلة التوثيق والمعرفة في خريطة التعلم، وبعده مقالات الأدوات على صفحات الفريق نفسه، ثم مقارنة بينها. وهذه المقالات المنشورة التي يعتمد عليها:
دليلOutline: قاعدة معرفة فريقك على سيرفرككيف تشغل Outline على سيرفرك ليكتب فيه فريقك إجراءاته وقراراته، ويدخل إليه الموظفون بحساباتهم في authentik.
دليلBookStack: توثيق فريقك في كتب وفصول على سيرفرككيف تشغل BookStack على سيرفرك وتنظم توثيق فريقك في أرفف وكتب وفصول، مع صلاحيات ودخول موحد وبحث بالعربية.
دليلدليل التشغيل Runbook: وثق الإجراء قبل أن تحتاجهنكتب دليل تشغيل لقاعدة بيانات امتلأ قرصها، ثم ننفذه بالثواني في يوم تجربة، فنكتشف فيه خطأين لم يظهرا إلا عند التنفيذ.
دليلتوثيق المعمارية: مخططات C4 وسجلات القرارات المعمارية ADRكيف ترسم نظامك بمخططات C4 يفهمها المطور الجديد، وتحفظ سبب كل قرار مهم في سجل ADR داخل المستودع.
دليلكيف يعمل البحث؟ الفهرس المعكوس Inverted Index وترتيب النتائجلماذا لا يكفي LIKE للبحث في تطبيقك، وكيف يجد محرك البحث الكلمات في جزء من الثانية ويرتب أهم النتائج في الأعلى.
دليلالبحث في النصوص العربية مع OpenSearch وMeilisearchلماذا يرجع البحث صفحة فارغة لمن يكتب «مستشفي» أو «اجازه»، وكيف تضبط محركك حتى يجد الكلمة بكل أشكالها.الخلاصة Summary
وصلنا لنهاية الموضوع، وأهم ما فيه:
- معرفة الفريق تضيع في أربعة أماكن: المحادثة، والمجلد المشترك، ورأس شخص واحد، وملفات README، والمحادثة جدول زمني يجيب عن سؤال اليوم، أما المعرفة فتحتاج إلى صفحة ثابتة تتحدث.
- الـ Wiki مكان واحد للمعرفة التي يكتبها ويقرؤها الفريق كله، مع بقاء توثيق الكود في المستودع والملفات النهائية في المجلد المشترك.
- كل صفحة تخدم حاجة واحدة بإطار Diátaxis: درس، أو دليل مهمة، أو مرجع، أو شرح، ولفرق التقنية سجل القرار ومراجعة الحادثة ودليل التشغيل.
- المساحات قليلة وبحسب المالك، والعمق قليل، والعنوان بكلمات الباحث، والقوالب تذكر الكاتب بما ينساه.
- لكل صفحة مالك وتاريخ مراجعة، لأن الصفحة القديمة أخطر من الناقصة، والقراءة مفتوحة إلا بسبب مكتوب، والأسرار خارج الـ Wiki.
- في المختبر على PostgreSQL وجد التطابق الحرفي 7 من 12 استعلاماً، والمحلل العربي 8، والحروف الثلاثية 12 مع صفحات إضافية، وحولت قاعدة للأفعال الاستعلام «سيرفر» إلى «يرفر»، وأفسد توحيدنا للحروف كلمة «مستوى»، وكل تغيير في البحث يختبر على كلمات حقيقية.
- العادات قبل الأداة: قاعدة المرة الثانية، والجواب برابط، وقناة للتوثيق، ونصف ساعة أسبوعياً للمراجعة.
وفي المقالات القادمة بإذن الله نبدأ بالأدوات، فنشغل Docmost على صفحات الفريق نفسها، ثم Wiki.js مع مزامنة Git، ثم HedgeDoc للكتابة المشتركة، ثم نقارن الأربعة بالقياس.
سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال وتنفيذ مختبر البحث العربي على PostgreSQL 18.6 من
postgres:18.6-alpineوDocker Engine 29.8.0.