مساكن جديدة للتوثيق الرسمي والمجتمعي

يسعدنا الإعلان عن بعض التحديثات المتعلقة بكيفية تعاملنا مع التوثيق لضمان الوضوح والتعاون مع الحفاظ على جودة المعلومات المقدمة. تابع القراءة لفهم كيفية عمل إعدادات التوثيق الجديدة لدينا.

:writing_hand: التوثيق الرسمي

قمنا بتحديث فئة Documentation لتكون مخصصة حصريًا للتوثيق الرسمي. وهذا يعني أن جميع المحتوى في فئاتها الفرعية يُدار من قبل أعضاء فريق Discourse، مما يضمن دقة المعلومات وتحديثها. إذا كنت تبحث عن أدلة ومرجعيات موثوقة، فهذا هو المكان!

لماذا يقتصر الأمر على أعضاء الفريق؟

إن تقييد إنشاء وتحرير التوثيق الرسمي على فريقنا يضمن الاتساق والموثوقية. نحن نسعى لتقديم موارد دقيقة ومُحدَّثة للجميع، من المستخدمين الجدد إلى المطورين ذوي الخبرة. لا يزال بإمكان جميع أعضاء المجتمع الرد على هذه المواضيع لمناقشة المحتوى أو اقتراح تعديلات.

:people_hugging: ويكي المجتمع

لا تقلق، فهناك مساحة واسعة لمساهماتك أيضًا! يمكن الآن العثور على جميع التوثيق الذي يساهم به المجتمع في فئة Wiki. هذا هو المكان الذي تجتمع فيه خبرات المجتمع ونصائحه ومعرفته الجماعية.

من يمكنه المساهمة؟

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

:question: لماذا هذا التغيير؟

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

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

:derek_pointing: نحن نحتاجكم!

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


يمكنكم العثور على سياسة التوثيق هذه في مكانها الدائم هنا:

10 إعجابات

هل يمكنني معرفة ما سيحدث لشارة Scribe؟

4 إعجابات

هل هناك طريقة مباشرة للبحث في كلا مصدري التوثيق في وقت واحد؟ أنا على علم بأنه يمكنني البحث عبر فئات متعددة، ولكن هذا أكثر صعوبة من مجرد إضافة “Documentation” بمساعدة الإكمال التلقائي.

أعتقد أنه يمكنني استخدام in:docs بدلاً من ذلك، لأن كلا الفئتين مضافتان إليها؟ in:kb والذي عمل أيضًا لـ Discourse Docs لا يبدو أنه يعمل.

وكيف يعمل هذا للفئات الفرعية؟ على سبيل المثال، كيف أبحث عن جميع المعلومات المكتوبة للمستخدمين؟ هل يمكنني البحث في #community-wiki:users و #documentation:using-discourse في نفس الوقت؟

5 إعجابات

مثال على علامة كلاسيكية. ولكن… سيكون هناك عدد هائل من العلامات التي يكاد يكون من المستحيل إدارتها.

3 إعجابات

تم تحديث شارة الناسخ لتشمل المساهمات في الويكي المجتمعي :slight_smile:

3 إعجابات

نعم - يمكنك استخدام in:docs وسيبحث في المواضيع في Documentation و Wiki في نفس الوقت.

ستشمل النتائج المواضيع الموجودة في الفئات الفرعية، لذا فهي بالفعل جزء من النتائج.

لذلك، ستحتاج إلى تحديد categories:users,using-discourse في البحث.

إعجابَين (2)

ولكن كل هذه تتطلب معرفة متعمقة بـ Discourse، لأن أياً منها غير مدعوم في واجهة البحث (المتقدمة).
ألا ينبغي أن تكون الوثائق سهلة البحث قدر الإمكان؟

5 إعجابات

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

يمثل هذا فرصة رائعة وحافزًا إضافيًا للعمل على تحديثات كهذه، لذا سنرى ما يمكننا فعله هناك! سنناقش هذا، وسأعود هنا بأي تحديثات.

4 إعجابات