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

[hugh (Hugh Lashbrooke)]

تعد وثائق Discourse هي الموقع الأساسي للمسؤولين والمشرفين والمستخدمين ومديري الأنظمة للعثور على المساعدة في استخدام Discourse وإدارة مواقعهم.

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

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

مواقع الوثائق

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

شارات لمساهمي الوثائق

سيتم تلقائيًا تعيين شارة الناسخ البرونزية لأي شخص ينشئ موضوعًا جديدًا في فئة Community wiki

إذا تم اعتبار الموضوع ذا قيمة كافية لنقله إلى فئة Documentation الرسمية، فسيقوم شخص ما في فريق Discourse بذلك يدويًا، ويشيد بالمؤلف الأصلي في محتوى الموضوع، ويعينه شارة الكاتب الشبح الفضية:

الوثائق التي تحتاج إلى كتابتها

بينما نريد في النهاية رؤية كل جزء من Discourse موثقًا بشكل شامل، هذه هي المجالات التي حددناها على أنها الأكثر إلحاحًا (تشير العناصر المشطوبة إلى مواضيع تم كتابتها منذ نشر هذا المنشور لأول مرة):

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

قد يتطلب بعض هذه العناصر مواضيع متعددة لتوثيقها بفعالية.

كيفية كتابة الوثائق

لضمان أن تكون وثائق Discourse فعالة قدر الإمكان، لدينا دليل أسلوب لكيفية كتابة هذا المحتوى. في حين أنه سيكون من المفيد للجميع اتباع الدليل، إذا كنت تساهم في #community-wiki، فليس من المشكلة إذا لم تلتزم به بالكامل. سيتم تحديث أي مواضيع يتم نقلها إلى Documentation بواسطة موظفي Discourse لمطابقة دليل الأسلوب حسب الحاجة.

مهتم؟

انتقل إلى Community wiki وابدأ في التوثيق اليوم. إذا كنت ترغب في مناقشة أي من هذا، فلا تتردد في الرد على هذا الموضوع للتحدث عنه.

[Moin]

ماذا عن المواضيع الموجودة؟ مثل على سبيل المثال

@hugh

كيفية منح امتيازات المسؤول أو المشرف للمستخدمين

Promoting a User to Admin or Moderator Status

This is a how-to guide intended to help existing site admins understand how to promote a user to admin or moderator status through Discourse. Required user level: Administrator Admin privileges in Discourse are powerful and allow the user to manage almost all aspects of the site. For full details on what staff users can do on a site, see Understanding user statuses, roles, and permissions. Here is a step-by-step process on how to promote a user to admin or …

@hugh

كيفية كتابة طلب ميزة جيد لـ Discourse

Requesting new features for Discourse

This guide explains how to request new features for Discourse, check existing plans, and increase the chances of your feature request being prioritized. Required user level: Anyone can submit a feature request Got a great idea for a Discourse feature? That’s fantastic! Here’s how you can share it with the team effectively. Make sure your feature isn’t already made or planned Before submitting a new feature request, ensure it’s not already available or plann…

[hugh (Hugh Lashbrooke)]

@Moin

@hugh

كيفية كتابة طلب ميزة جيد لـ Discourse

طلب ميزات جديدة لـ Discourse

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

@Moin

@hugh

كيفية منح امتيازات المسؤول أو المشرف للمستخدمين

منح امتيازات المسؤول أو المشرف لمستخدم

ملاحظة جيدة! سأقوم بإزالة ذلك من القائمة في هذا الموضوع

[ondrej]

@hugh

كيفية كتابة طلب ميزة جيد لـ Discourse

يوجد هذا الموضوع الذي يغطي طلبات الميزات بالفعل

Requesting new features for Discourse

This guide explains how to request new features for Discourse, check existing plans, and increase the chances of your feature request being prioritized. Required user level: Anyone can submit a feature request Got a great idea for a Discourse feature? That’s fantastic! Here’s how you can share it with the team effectively. Make sure your feature isn’t already made or planned Before submitting a new feature request, ensure it’s not already available or plann…

ما لم يكن بحاجة إلى أن يبدو مثل هذا ولكن لطلب ميزة؟

Writing an effective bug report

This is a guide for writing effective bug reports in Discourse to maximize the chances of getting bugs fixed. Required user level: Any can report a bug Writing a good bug report is essential to help the Discourse team fix issues efficiently. This guide will walk you through the steps and best practices to ensure your bug report is clear, concise, and actionable. Summary In this documentation, we’ll cover: The importance of providing reproducible steps and…

[HamMan2118]

@hugh

إشعارات المشاركة

هل هذا يعني إشعار الموظفين أم شيء مختلف؟

[ondrej]

أفترض أن هذه ملاحظة نشر لأنها في العنوان

Post notices for first-time and returning users

To encourage kindness towards users who are posting for the first time or may not have posted in a while we’ve created a new feature that calls special attention to these new/returning users. These banners are visible to other users, but not the poster they apply to… and by default are only visible to community members who have been active enough to achieve Trust Level 2. Here’s what they look like: [image] [image] How can I configure this feature? Admins can adjust these options in their…

ملاحظات الموظفين هي نفسها تقريبًا على ما أعتقد؟

[hugh (Hugh Lashbrooke)]

@ondrej

إلا إذا كان يجب أن يبدو هكذا ولكن لطلب ميزة؟

نعم هذا ما نبحث عنه هناك

@HamMan2118

@hugh

إشعارات المشاركات

هل هذا يعني إشعار الموظفين أم شيء مختلف؟

كما أشار @ondrej، فإن إشعارات المشاركات هي ما هو موضح في هذا الإعلان. لدينا موضوع الإعلان هذا، ولكن ليس لدينا وثائق فعلية عنه.

[Heliosurge (Dan DeMontmorency)]

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

• قوالب منتديات الدعم
• قوالب منصات التعلم

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

[NateDhaliwal]

@hugh

حالات المستخدم

تم الإنشاء:

Custom User Statuses

Summary This document covers: What a Custom User Status Is How to add, modify, and remove a custom user status. Custom User Status Description A Custom User Status is a feature where users can set a custom status and icon to appear in their profile and next to their avatar at posts. This can be used, as a member, to let the community know if you are unavailable, on vacation, or want to share how you are feeling. A custom user status appears like this in a post: [Username "andrei" with a pal…

[hugh (Hugh Lashbrooke)]

رأيت ذلك :ابتسامة: من الرائع رؤية هذه الأشياء قادمة!

[NateDhaliwal]

أعمل على وضع الظلام.

[NateDhaliwal]

تم إنشاء هذه الأدلة بالفعل ولكن لم يتم التحقق منها بعد:

@hugh

حالات المستخدم

Custom User Statuses

Summary This document covers: What a Custom User Status Is How to add, modify, and remove a custom user status. Custom User Status Description A Custom User Status is a feature where users can set a custom status and icon to appear in their profile and next to their avatar at posts. This can be used, as a member, to let the community know if you are unavailable, on vacation, or want to share how you are feeling. A custom user status appears like this in a post: [Username "andrei" with a pal…

@hugh

استخدام شبكات الصور في المشاركات

Image Grids

This guide explains what Image Grids are and how to apply them in your posts. Required user level: Trust Level 0 Summary This document covers: Description of image grids How they can be applied in posts and how to modify them Basic Layout of image grids Image Grids Description An image grid places all of the images in your post into a neat, organized grid - rather than in a list. Below is an example of an image grid. [Delta A321-200 Landing in Washingt…

@hugh

الصفحات الرئيسية المخصصة

هذه الصفحة ضبابية بعض الشيء. هل تشير إلى محتوى الصفحة الرئيسية المخصص؟ إذا كان الأمر كذلك، فربما Add custom content that only appears on your homepage. بخلاف ذلك… لم تتم كتابتها بعد.

[hugh (Hugh Lashbrooke)]

شكرًا على التواصل مرة أخرى هنا - لقد قمت بتحديث OP بهذه الروابط.

[اقتباس=“NateDhaliwal، مشاركة:22، موضوع:326614”]
هذه الصورة غير واضحة بعض الشيء. هل تشير إلى محتوى الصفحة الرئيسية المخصصة؟

[/اقتباس]

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