ملخص
يغطي موضوع التوثيق هذا كيفية كتابة طلب ميزة في ديسكورس: دليل خطوة بخطوة.
الخطوة 1: قبل أن تبدأ
إذًا، لديك فكرة رائعة لميزة في ديسكورس؟ هذا رائع! إليك كيف يمكنك مشاركتها مع الفريق والمجتمع بفعالية. قبل إرسال طلب ميزة، يرجى أخذ لحظة للبحث في المناقشات الحالية لمعرفة ما إذا كانت فكرتك قد تم اقتراحها أو تنفيذها بالفعل. يمكنك القيام بذلك بعدة طرق:
- البحث في فئة Feature (الميزة)
- بالنقر على أيقونة
(العدسة المكبرة) في الزاوية اليمنى العليا من الصفحة لعرض البحث. يمكنك استخدام المرشحات المتقدمة للتصفية حسب الفئة والوسم. - البحث في المواضيع التي تحمل الوسم pr-welcome - يشير PR إلى طلب سحب (pull request) على GitHub - وهي طريقة للمطورين لتقديم شفرة جديدة إلى المشروع.
- البحث في المواضيع التي تحمل الوسم completed (مكتمل)
- البحث في فئتي Plugin (الإضافة) و Theme component (مكون السمة)
إذا كان اقتراح الميزة الخاص بك مدرجًا بالفعل، يمكنك دعمه عن طريق التصويت عليه لجعله أكثر بروزًا، والإعجاب به، والرد بأفكار إضافية أو حالات استخدام، لتوصيل فائدته بشكل أكبر وسبب إضافة الميزة.
ألم تتمكن من العثور على أي ذكر لفكرتك؟ يمكنك إنشاء طلب ميزة.
الخطوة 2: الأساسيات
العنوان
من المهم أن تكون عناوين المواضيع إعلامية، ولكن في نفس الوقت ليست طويلة جدًا. يجب أن يكون نطاق الطلب قابلاً للتعرف عليه بسهولة بنظرة سريعة.
الفئة
عند إنشاء موضوع جديد، يرجى تحديد فئة Feature (الميزة).
الوسم
تُستخدم العلامات لتجميع الميزات وتصنيفها، لذلك، للحفاظ على تنظيم الطلبات، يعد وسم موضوعك بشكل مناسب مفيدًا جدًا لأغراض التتبع. على سبيل المثال، يتم تجميع كل ما يتعلق بإضافة chat (الدردشة) تحت وسم واحد.
الخطوة 3: كتابة طلبك
يعد كتابة طلب ميزة جيد أمرًا مهمًا، فهو يساعد فريق ديسكورس على تحديد المجالات التي قد تحتاج إلى تحسين بسرعة.
تذكر، عند إنشاء طلب ميزة، فإنك تحاول عرض فكرتك وإقناع الناس بأن فكرتك للميزة مؤسسة جيدًا. اشرح لماذا تريد إضافة ميزتك إلى: المجتمع، ونفسك، والفريق.
في نص موضوعك، اذكر بإيجاز الميزة التي تطلبها. كن محددًا ووصفيًا، وتجنب الغموض أو الانفتاح.
تقديم السياق والشرح
قدم سياقًا وشرحًا لطلب الميزة الخاص بك.
- وصف واضح للميزة التي تطلبها
- تضمين المشكلة أو حالات الاستخدام لنضالك الحالي وكيف ستحلها ميزتك
- أي معلومات أساسية أو أبحاث ذات صلة قمت بها
تقديم الأمثلة ولقطات الشاشة (اختياري)
إذا كان ذلك منطبقًا، قدم أمثلة أو نماذج أولية أو لقطات شاشة للمساعدة في توضيح طلب الميزة الخاص بك حتى يتمكن الآخرون من تصور فكرتك بسهولة.
التفاعل مع المجتمع
بمجرد إنشاء طلب الميزة الخاص بك، تفاعل مع الأعضاء من خلال الرد على الأسئلة والملاحظات. سيساعد هذا في زيادة فرص النظر في طلبك.
ماذا تتوقع بعد ذلك
بعد إرسال طلب الميزة الخاص بك، ستتم مراجعته من قبل المجتمع وفريق ديسكورس. يمكنك أن تتوقع:
- ملاحظات ومناقشة من المجتمع
- رد من موظفي ديسكورس يشير إلى ما إذا كان طلبك ممكنًا وقيد النظر
- التنفيذ المحتمل لطلب الميزة الخاص بك في تحديث مستقبلي
هل تريد التأكد من صنع ميزتك؟
في بعض الحالات، قد لا تكون طلبات الميزات مناسبة للنواة (core). يمكنك قراءة كيفية اتخاذ قرارات الميزات. إذا لم تتمكن من تطوير الميزة بنفسك، فلا تزال هناك طرق لزيادة فرص صنعها.
كن عميلاً لـ discourse.org
إذا كنت ترغب في تمويل التطوير عن طريق استضافة مواقع معنا - فنحن نعطي الأولوية دائمًا لطلبات العملاء في جدولنا الزمني للتطوير - فهذه إحدى الطرق لإدخالها بشكل أسرع. يمكن لـ عملاء المؤسسات (Enterprise customers) طلب ميزات مخصصة (عادةً في شكل إضافة) من قبل الفريق الأساسي بسعر بالساعة.
رعاية مهمة “pr-welcome” (مرحبًا بطلب السحب)
لدينا قائمة شاملة بمواضيع pr-welcome. هذه مهام نود أن نراها مكتملة، ولكن ليس لدينا حاليًا النطاق الترددي للعمل عليها بأنفسنا. تعد رعاية شخص ما للعمل على هذه المهام طريقة رائعة للمشاركة، ويتم تقدير أي مساهمة في ديسكورس بشكل كبير.
عرض عمل مدفوع في السوق (Marketplace)
إذا كانت هناك إضافة تحتاجها وهي ضرورية لعملك، فقم بالإعلان عن مهمة مدفوعة في فئة Marketplace (السوق). قدم أكبر قدر ممكن من التفاصيل، بما في ذلك لقطات الشاشة والميزانية. قد تجد أيضًا مستقلين يعرضون خدمات مصغرة موحدة مثل “تثبيت لمرة واحدة” أو “سمة مخصصة”.
الإجمالي
إيجابيات وسلبيات عامة
افعل
- اجعل طلبك موجزًا ومركزًا على ميزة واحدة
- تجنب وضع افتراضات حول التنفيذ أو التفاصيل التقنية
- أظهر استعدادًا لتقديم تنازلات وتكييف فكرتك بناءً على ملاحظات المجتمع
لا تفعل
- تضمين أكثر من ميزة واحدة في كل موضوع
- ترك الآخرين يتساءلون عن نطاق طلبك
الأسئلة الشائعة
س: ماذا لو لم يكن لدي وقت لإنشاء طلب ميزة مفصل؟
ج: إذا لم تتمكن في تلك اللحظة من إنشاء طلب مفصل، ففكر فيما تريد قوله وحاول مرة أخرى لاحقًا. يضمن هذا تقديم أفضل حالة لديك، مما يزيد من احتمالية دعم الآخرين لطلبك وإضافته.
س: أين يجب أن أنشر طلب الميزة الخاص بي؟
ج: استخدم الفئة المناسبة - يجب أن تذهب طلبات الميزات إلى فئة Feature.
س: ماذا لو لم أكن متأكدًا من الوسم الذي يجب استخدامه لطلبي؟
ج: على الرغم من أن العلامات تتطابق مع أسماء الإضافات ومكونات السمة لسهولة الاستخدام، سيقوم أحد أعضاء الفريق أو عضو منتظم بإلحاق وسم مناسب بموضوعك إذا تُرك فارغًا.
كن محترمًا ومنفتحًا في طلبك. تجنب استخدام طلب الميزة للتعبير عن الإحباط. قد يؤدي أي لغة أو سلوك غير لائق إلى تأخير طلبك أو تجاهله.
موارد إضافية
- الفئات: Feature (الميزة)، Marketplace (السوق)، Plugin (الإضافة)، Plugin > Extras (إضافات)، Theme (السمة)، Theme component (مكون السمة)
- الوسوم: current-projects (المشاريع الحالية)، release-notes (ملاحظات الإصدار)، pr-welcome (مرحبًا بطلب السحب)، planned (مخطط له)
- https://meta.stackexchange.com/questions/258136/how-do-i-write-a-good-feature-request
- How do we decide what goes into each release of Discourse?
- Discourse pricing | Discourse - Civilized Discussion
