مقالة قاعدة المعرفة

# /kb-article

> إذا رأيت عناصر نائبة غير مألوفة أو كنت بحاجة للتحقق من الأدوات المتصلة، انظر إلى [CONNECTORS.md](../../CONNECTORS.md).

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

## الاستخدام

``` /kb-article <المشكلة المحلولة أو مرجع التذكرة أو وصف الموضوع> ```

أمثلة: - `/kb-article كيفية تكوين المصادقة الموحدة (SSO) باستخدام Okta — حللنا هذا لـ 3 عملاء الشهر الماضي` - `/kb-article التذكرة #4521 — العميل لم يتمكن من تصدير البيانات التي تتجاوز 10000 صف` - `/kb-article سؤال شائع: كيفية إعداد إخطارات Webhook` - `/kb-article مشكلة معروفة: رسوم البيانات في لوحة المعلومات لا تحمل على Safari 16`

## سير العمل

### 1. فهم المواد المصدرية

حلل المدخلات لتحديد:

- **ما كانت المشكلة؟** المشكلة الأصلية أو السؤال أو الخطأ - **ما كان الحل؟** القرار أو الحل البديل أو الإجابة - **من يتأثر بهذا؟** نوع المستخدم أو مستوى الخطة أو التكوين - **ما مدى شيوع هذا؟** مشكلة فريدة أم متكررة - **أي نوع مقالة مناسب؟** إرشادات عملية أم استكشاف أخطاء أم أسئلة شائعة أم مشكلة معروفة أم مرجع (انظر أنواع المقالات أدناه)

إذا تم تقديم مرجع تذكرة، ابحث عن السياق الكامل:

- **منصة الدعم**: استخرج خيط التذكرة والقرار وأي ملاحظات داخلية - **قاعدة المعارف**: تحقق من وجود مقالة مشابهة بالفعل (تحديث مقابل إنشاء جديد) - **متتبع المشروع**: تحقق من وجود خطأ أو طلب ميزة ذي صلة

### 2. صياغة المقالة

باستخدام نموذج المقالة ومعايير التنسيق وأفضل الممارسات لقابلية البحث أدناه:

- اتبع القالب الخاص بنوع المقالة المختار (إرشادات عملية أو استكشاف أخطاء أو أسئلة شائعة أو مشكلة معروفة أو مرجع) - طبق أفضل ممارسات قابلية البحث: عنوان بلغة العميل، جملة افتتاحية سهلة الفهم، رسائل الخطأ الدقيقة، المرادفات الشائعة - اجعلها قابلة للمسح الضوئي: رؤوس وخطوات مرقمة وفقرات قصيرة

### 3. إنشاء المقالة

قدم المسودة مع البيانات الوصفية:

``` ## مسودة مقالة قاعدة المعارف

**العنوان:** [عنوان المقالة] **النوع:** [إرشادات عملية / استكشاف أخطاء / أسئلة شائعة / مشكلة معروفة / مرجع] **الفئة:** [منطقة المنتج أو الموضوع] **الوسوم:** [وسوم قابلة للبحث] **الجمهور:** [جميع المستخدمين / المسؤولين / المطورين / خطة محددة]

---

[محتوى المقالة الكاملة — باستخدام القالب المناسب أدناه]

---

### ملاحظات النشر - **المصدر:** [التذكرة #، محادثة العميل أو نقاش داخلي] - **المقالات الموجودة المراد تحديثها:** [إذا كان هناك تداخل مع محتوى موجود] - **يتطلب المراجعة من:** [خبير موضوع أو فريق إذا كانت دقة تقنية تتطلب تحقق] - **تاريخ المراجعة المقترح:** [متى تعيد النظر للتحقق من الدقة] ```

### 4. تقديم الخطوات التالية

بعد إنشاء المقالة: - "هل تريد مني أن أتحقق من وجود مقالة مشابهة بالفعل في قاعدة المعارف الخاصة بك؟" - "هل يجب أن أعدل عمق التفاصيل التقنية لجمهور مختلف؟" - "هل تريد مني أن أصيغ مقالة مرفقة (على سبيل المثال، إرشادات عملية لترافق هذا دليل استكشاف الأخطاء)؟" - "هل يجب أن أنشئ نسخة داخلية فقط مع تفاصيل تقنية إضافية؟"

---

## هيكل المقالة ومعايير التنسيق

### عناصر المقالة الشاملة

يجب أن تتضمن كل مقالة قاعدة معارف:

1. **العنوان**: واضح وقابل للبحث، يصف النتيجة أو المشكلة (لا المصطلحات الداخلية) 2. **نظرة عامة**: جملة واحدة أو جملتان تشرحان ما تغطيه هذه المقالة ومن هي موجهة له 3. **النص**: محتوى منظم مناسب لنوع المقالة 4. **المقالات ذات الصلة**: روابط إلى محتوى مرفق ذي صلة 5. **البيانات الوصفية**: الفئة والوسوم والجمهور وتاريخ آخر تحديث

### قواعد التنسيق

- **استخدم الرؤوس (H2، H3)** لتقسيم المحتوى إلى أقسام قابلة للمسح - **استخدم القوائم المرقمة** للخطوات المتسلسلة - **استخدم قوائم النقاط** للعناصر غير المتسلسلة - **استخدم الخط الغامق** لأسماء عناصر واجهة المستخدم والمصطلحات الرئيسية والتأكيد - **استخدم كتل الأكواد** للأوامر واستدعاءات API ورسائل الخطأ وقيم التكوين - **استخدم الجداول** للمقارنات والخيارات أو بيانات المرجع - **استخدم الإشعارات/الملاحظات** للتحذيرات والنصائح والملاحظات المهمة - **اجعل الفقرات قصيرة** — بحد أقصى 2-4 جمل - **فكرة واحدة لكل قسم** — إذا كان القسم يغطي موضوعين، اقسمه

## الكتابة لقابلية البحث

المقالات عديمة الفائدة إذا لم يتمكن العملاء من العثور عليها. حسّن كل مقالة لقابلية البحث:

### أفضل ممارسات العنوان

| عنوان جيد | عنوان سيء | السبب | |-----------|----------|------| | "كيفية تكوين المصادقة الموحدة (SSO) باستخدام Okta" | "إعداد المصادقة الموحدة (SSO)" | محدد، يتضمن اسم الأداة التي يبحث عنها العملاء | | "إصلاح: لوحة المعلومات تعرض صفحة فارغة" | "مشكلة لوحة المعلومات" | يتضمن الأعراض التي يواجهها العملاء | | "حدود معدل API والحصص" | "معلومات API" | يتضمن المصطلحات المحددة التي يبحث عنها العملاء | | "خطأ: 'الاتصال مرفوض' عند استيراد البيانات" | "مشاكل الاستيراد" | يتضمن رسالة الخطأ الدقيقة |

### تحسين الكلمات الرئيسية

- **قم بتضمين رسائل الخطأ الدقيقة** — ينسخ العملاء نص الخطأ في البحث - **استخدم لغة العميل** وليس المصطلحات الداخلية — "لا يمكن تسجيل الدخول" وليس "فشل المصادقة" - **قم بتضمين المرادفات الشائعة** — "حذف/إزالة" و"لوحة المعلومات/الصفحة الرئيسية" و"تصدير/تحميل" - **أضف بدائل**