نموذج إرشادي: فريق توثيق منتجات يبني نظام معرفة داخلي وخارجي ببنية مفتوحة

تفاصيل السيناريو

مقدمة عن السيناريو

نموذج إرشادي لفريق توثيق منتجات في شركة برمجيات صغيرة، يبني stack توثيق ثنائي (داخلي للفريق + عام للعملاء) على Nextcloud + GitBook-style site + AI Assistant، مع تكامل مع نظام الدعم.

توصيف المشكلة

شركة برمجيات صغيرة تنمو، منتجها يستخدمه آلاف العملاء. وثائق المنتج متفرقة: مسودات في Google Docs، نسخ نهائية على موقع docs مبني بـ Hugo، أسئلة العملاء المتكررة في تذاكر Intercom، ملاحظات اجتماعات المهندسين في Notion. الفريق التوثيقي (3 كتّاب تقنيين) يقضي وقتاً ضخماً في النسخ بين الأنظمة، الإجابة على أسئلة الدعم بكلمات تخالف الوثائق الرسمية أحياناً، ومحاولة إبقاء الوثائق محدّثة مع تغييرات المنتج اليومية. النتيجة: تذاكر دعم متزايدة بأسئلة كان يجب أن تجيب عليها الوثائق، إحباط الفريق التوثيقي، وعملاء غير راضين.

الأدوات المستخدمة

• nextcloud: أداة مستخدمة في سير العمل.
• outline: أداة مستخدمة في سير العمل.
• mkdocs: أداة مستخدمة في سير العمل.
• open-webui: أداة مستخدمة في سير العمل.
• ollama: أداة مستخدمة في سير العمل.
• chatwoot: أداة مستخدمة في سير العمل.
• coolify: أداة مستخدمة في سير العمل.
• n8n: أداة مستخدمة في سير العمل.

مسار العمل (Workflow)

بناء stack توثيق متكامل: 1. Nextcloud كقاعدة الملفات والمسوّدات للفريق الداخلي (يستبدل Google Drive) 2. Outline أو BookStack كنظام wiki داخلي (يستبدل Notion للوثائق التقنية، يبقى Notion للتخطيط) 3. موقع docs عام مبني بـ MkDocs Material أو Docusaurus، يُنشر من نفس مستودع المحتوى 4. Open WebUI + Ollama + RAG على كل الوثائق (داخلية + عامة) كمساعد ذكي 5. تكامل مع نظام الدعم (Chatwoot self-hosted) — وكلاء الدعم يرون اقتراحات من الوثائق 6. Single source of truth: كل المحتوى في Git repository مكتوب Markdown، يُنشر للموقع + يُفهرس للـ AI

النتائج والفرق في الأداء

• قبل التطبيق:
• بعد التطبيق:

التكلفة التقديرية

الدروس المستفادة

• Single source of truth يبدأ بقرار صعب: “نختار أداة واحدة لكل نوع محتوى” — أي بقاء أداتين متشابهتين قاتل • الفريق التوثيقي قاوم في البداية لأنه فقد ميزات Notion المحبوبة — الحل: استثمار في تعليم Outline + إضافة plugins لسد الفجوات • AI Assistant ينقذ تذاكر دعم فقط إذا كانت الوثائق المُفهرسة عالية الجودة — لا تفهرس وثائق ناقصة وتأمل الأفضل • Glossary موحّد للمنتج (أسماء الميزات، المصطلحات التقنية) خفّض الالتباس في الإجابات بشكل ملحوظ • المستخدمون النهائيون (عملاء الشركة) يطرحون أسئلة بصياغات لم نتوقعها — منهم نتعلم كيف نكتب • تكامل Chatwoot أنقذ متوسط زمن الرد للفريق — الوكلاء يبدؤون بالاقتراح، يعدّلون، يرسلون • بعض الأسئلة المتكررة تكشف عيوباً في المنتج نفسه — التوثيق ليس حلاً لكل شيء • بعد سنة، عدد الكتّاب الذين يساهمون من خارج الفريق (مهندسون، PMs) ارتفع لأن الأداة سهلة — هذا أفضل أثر غير متوقع