Free cloud beta or self-host with the public AGPL-3.0 release.Compare options
كل المقالات
بنية المعلوماتالتعاونالنشر

مختبر بنية معلومات التوثيق والتعاون

صمم شجرة التوثيق من مهام القراء وأنواع الصفحات والملكية وحالات المراجعة وقابلية العثور قبل نقل المحتوى كله.

· 11 دقائق قراءة · بقلم

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

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

اجمع مهام القراء لا عناوين الصفحات المطلوبة

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

لكل مهمة سجّل الجمهور، والسياق السابق، ودرجة الاستعجال، والمعلومة المطلوبة، ونقطة النجاح. لا تحول كل طلب داخلي إلى صفحة؛ قد يكون المطلوب تحسين صفحة قائمة أو واجهة المنتج.

اختر أنواع صفحات بوعود مختلفة

يحتاج القارئ إلى معرفة نوع الإجابة قبل فتحها:

  • درس ينقله من نقطة بداية إلى نتيجة كاملة؛
  • دليل مهمة يشرح إجراءً محدداً لقارئ يعرف الأساسيات؛
  • مرجع يصف الحقول والقيم والسلوك من دون سرد طويل؛
  • تفسير مفاهيمي يشرح لماذا يعمل النظام بهذه الطريقة؛
  • استكشاف أعطال يبدأ بعرض ظاهر ويقود إلى تشخيص؛
  • سجل قرار أو تشغيل يحدد الأدلة والمالكين وشروط التراجع.

لا تخلط ثلاثة وعود في عنوان واحد. اربط الأنواع ببعضها: الدرس يقود إلى المرجع، والخطأ يقود إلى التشخيص، والقرار يقود إلى runbook.

ارسم مساراً واحداً من البداية إلى النهاية

اختر مهمة عالية القيمة وارسم الرحلة: صفحة الدخول، المتطلبات، الإجراء، التحقق، الخطأ المتوقع، والخطوة التالية. افتح كل رابط كما يراه مستخدم جديد، لا ككاتب يعرف مكان المحتوى.

نقطة المسارسؤال الاختبار
الدخولهل يفهم القارئ أن هذه الصفحة تناسب مهمته؟
المتطلباتهل يعرف الحساب والدور والإصدار اللازم؟
الإجراءهل الخطوات قابلة للتنفيذ بالترتيب؟
التحققهل توجد نتيجة مرئية أو أمر فحص؟
التعافيهل يقود الفشل الشائع إلى تشخيص لا تخمين؟
التاليهل يخرج القارئ إلى المهمة المنطقية التالية؟

صمم التنقل حول مفاهيم مستقرة

تتغير أسماء الفرق أسرع من مهام القراء. استخدم مفاهيم المنتج ودورة العمل بدلاً من org chart. اجعل المستوى الأول صغيراً، وتجنب تكرار الصفحة في فروع كثيرة لإخفاء بنية ضعيفة.

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

عرّف الملكية على مستوى الصفحة والنظام

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

استخدم قواعد مثل:

  • مالك محتوى لكل مجال؛
  • مراجع فني أو قانوني عند الحاجة؛
  • تاريخ مراجعة للمعلومات الحساسة للزمن؛
  • بديل عند مغادرة المالك؛
  • قناة واضحة للإبلاغ عن الخطأ.

اجعل حالات المراجعة صريحة

استخدم حالات قليلة ذات معنى: مسودة، جاهز للمراجعة، معتمد، منشور، يحتاج مراجعة. حدد من يستطيع الانتقال بين الحالات وما الدليل المطلوب.

لا تجعل "محفوظ" مرادفاً لـ"منشور". المعاينة يجب أن تعرض المسودة فقط للمخولين، بينما يبقى الموقع العام على لقطة الإصدار السابقة حتى إجراء نشر صريح.

اختر حد التعاون عمداً

يعمل Git جيداً عندما يراجع الفريق فروق النص والشيفرة معاً. يعمل المحرر المرئي جيداً عندما يكتب الدعم والمنتج والكتابة باستمرار. قد يجمع الفريق بينهما، لكن عليه تعريف اتجاه المزامنة ومن يحل التعارض.

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

اختبر قابلية العثور قبل نقل كل شيء

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

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

خطط لإعادة التنظيم كترحيل

أنشئ خريطة من كل رابط قديم إلى الجديد، وحدد canonical وhreflang والتحويل. جرّبها على نطاق مؤقت، ثم راقب 404 والبحث والروابط بعد القطع. احتفظ بقدرة العودة إلى الشجرة القديمة حتى تتجاوز شروط القبول.

تطبيق المختبر على Nibleaf

يتيح Nibleaf أشجار صفحات ولقطات نشر وتعليقات وأدواراً وبحثاً وتصدير Markdown. استخدم هذه الأدوات لبناء مسار واحد أولاً. لا تعتبر مرونة المحرر بديلاً عن owner أو حالة مراجعة أو خريطة تحويل.

المراجع وتاريخ المراجعة

رُوجعت المراجع في 2026-09-03: Diátaxis، إرشادات GOV.UK لاحتياجات المستخدم، Google حول بنية روابط الموقع، وW3C حول لغة الصفحة.

انشر وثائق واضحة بالعربية والإنجليزية

ابدأ مجانًا على Nibleaf Cloud، أو شغّل الإصدار العام المرخّص بـ AGPL على بنيتك التحتية.