الملخص
تتناول هذه الوثيقة موضوع كتابة طلب ميزة في Discourse: دليل خطوة بخطوة.
الخطوة 1: قبل البدء
لديك فكرة رائعة لميزة في Discourse؟ هذا رائع! إليك كيفية مشاركتها مع الفريق والمجتمع بفعالية. قبل تقديم طلب ميزة، يرجى تخصيص لحظة للبحث في المناقشات الموجودة لمعرفة ما إذا كانت فكرتك قد اقترحت أو نفذت بالفعل. يمكنك القيام بذلك بعدة طرق:
- البحث في فئة Contribute > Feature
- بالنقر على أيقونة
في الزاوية العلوية اليمنى من الصفحة لاستدعاء البحث. يمكنك استخدام فلاتر متقدمة للتصفية حسب الفئة والوسم. - الاطلاع على المواضيع التي تحمل وسم pr-welcome - PR هو اختصار لـ Pull Request على GitHub، وهو طريقة للمطورين لإدخال كود جديد إلى مشروع.
- الاطلاع على المواضيع التي تحمل وسم completed
- البحث في فئات Customization > Plugin و Customization > Theme component
إذا كانت اقتراح الميزة الخاص بك مدرجًا بالفعل، يمكنك دعمه من خلال التصويت له لجعل طلباته أكثر بروزًا، والإعجاب به، والرد بأفكار إضافية أو حالات استخدام، لمزيد من التواصل حول فائدته ولماذا يجب إضافة الميزة.
لم تجد أي ذكر لفكرتك؟ يمكنك إنشاء طلب ميزة.
الخطوة 2: الأساسيات
العنوان
من المهم أن تكون عناوين المواضيع مفيدة، ولكن في نفس الوقت ليست طويلة جدًا. يجب أن يكون نطاق الطلب واضحًا للوهلة الأولى.
الفئة
عند إنشاء موضوع جديد، يرجى اختيار فئة Contribute > Feature.
الوسم
تُستخدم الوسوم لتجميع الميزات وتصنيفها، ولذلك، من أجل الحفاظ على تنظيم الطلبات، فإن وضع الوسوم المناسبة لموضوعك يساعد كثيرًا في التتبع. على سبيل المثال، كل ما يتعلق بـ chat plugin يتم تجميعه تحت وسم واحد.
الخطوة 3: كتابة طلبك
كتابة طلب ميزة جيد أمر مهم، فهو يساعد فريق Discourse على تحديد المجالات التي قد تحتاج إلى تحسين بسرعة.
تذكر، عند إنشاء طلب ميزة، أنك تحاول تقديم فكرتك وإقناع الناس بأن فكرتك في الميزة مبنية على أسس سليمة. اشرح لماذا تريد إضافة مميزتك إلى: المجتمع، لنفسك، وللفريق.
في نص موضوعك، اذكر الميزة التي تطلبها بإيجاز. كن محددًا ووصفيًا، وتجنب الغموض أو الانفتاح الزائد.
تقديم السياق والشرح
قدم سياقًا وشرحًا لطلب الميزة الخاص بك.
- وصف واضح للميزة التي تطلبها
- تضمين المشكلة أو حالات الاستخدام التي تواجهها حاليًا وكيف ستحل ميزتك هذه المشكلة
- أي معلومات خلفية ذات صلة أو بحث قمت به
تقديم الأمثلة لقطات الشاشة (اختياري)
إذا كان ذلك مناسبًا، قدم أمثلة أو نماذج أولية أو لقطات شاشة لمساعدة الآخرين على تصور فكرتك بسهولة.
التفاعل مع المجتمع
بمجرد إنشاء طلب الميزة الخاص بك، تفاعل مع الأعضاء من خلال الرد على الأسئلة والملاحظات. سيساعد ذلك في زيادة فرص أخذ طلبك في الاعتبار.
ماذا تتوقع بعد ذلك
بعد تقديم طلب الميزة الخاص بك، سيتم مراجعته من قبل المجتمع وفريق Discourse. يمكنك توقع:
- ملاحظات ومناقشات من المجتمع
- رد من موظفي Discourse يشير إلى ما إذا كان طلبك قابلاً للتنفيذ وخاضعًا للنظر
- تنفيذ محتمل لطلب الميزة الخاص بك في تحديث مستقبلي
تريد التأكد من أن ميزتك سيتم تنفيذها؟
في بعض الحالات، قد لا تكون طلبات الميزات مناسبة للنواة الأساسية (core). يمكنك قراءة كيفية اتخاذ قرارات الميزات. إذا لم تتمكن من تطوير الميزة بنفسك، فلا تزال هناك طرق لزيادة فرص تنفيذها.
أصبح عميلًا لـ discourse.org
إذا كنت ترغب في تمويل التطوير عن طريق استضافة مواقع معنا - فنحن نولي دائمًا الأولوية لطلبات العملاء في جدولنا الزمني - فهذه طريقة واحدة للحصول عليها بشكل أسرع. يمكن لـ عملاء Enterprise طلب ميزات مخصصة (عادةً في شكل إضافة) من قبل الفريق الأساسي بسعر بالساعة.
رعاية مهمة “pr-welcome”
لدينا قائمة شاملة من مواضيع pr-welcome. هذه هي المهام التي نود رؤيتها مكتملة، ولكن ليس لدينا حاليًا النطاق الزمني للعمل عليها بأنفسنا. رعاية شخص للعمل على هذه المهام هي طريقة رائعة للانخراط، وأي مساهمة في Discourse محل تقدير كبير.
عرض عمل مدفوع في Marketplace
إذا كانت هناك إضافة تحتاجها وهي حاسمة لعملك، فأعلن عن مهمة مدفوعة في فئة Marketplace. قدم أكبر قدر ممكن من التفاصيل، بما في ذلك لقطات الشاشة والميزانية. قد تجد أيضًا مستقلين يقدمون خدمات مصغرة قياسية مثل “التثبيت لمرة واحدة” أو “سمة مخصصة.”
بشكل عام
نعم نعم ونعم لا
نعم
- اجعل طلبك موجزًا ومركّزًا على ميزة واحدة
- تجنب افتراضات حول التنفيذ أو التفاصيل التقنية
- أظهر استعدادك للتنازل والتكيف مع فكرتك بناءً على ملاحظات المجتمع
لا
- لا تتضمن أكثر من ميزة واحدة لكل موضوع
- لا تترك الآخرين يتساءلون عن نطاق طلبك
الأسئلة الشائعة
س: ماذا لو لم يكن لدي وقت لإنشاء طلب ميزة مفصل؟
ج: إذا لم تتمكن في اللحظة من إنشاء طلب مفصل، فكر فيما تريد قوله وحاول مرة أخرى لاحقًا. يضمن ذلك تقديم أفضل حالة لك، مما يؤدي إلى زيادة فرص دعم الآخرين لطلبك وإضافته.
س: أين يجب أن أنشر طلب الميزة الخاص بي؟
ج: استخدم الفئة المناسبة - يجب أن تذهب طلبات الميزات إلى فئة #feature::category.
س: ماذا لو كنت غير متأكد من الوسم الذي يجب استخدامه لطلبي؟
ج: على الرغم من أن الوسوم تتطابق مع أسماء الإضافات ومكونات السمة لتسهيل الاستخدام، فإن عضوًا من الفريق أو عضوًا منتظمًا سيضيف وسمًا مناسبًا لموضوعك إذا تركته فارغًا.
كن محترمًا ومتفتح الذهن في طلبك. تجنب استخدام طلب الميزة للتعبير عن الإحباط. يمكن أن تؤدي أي لغة أو سلوك غير لائق إلى تأخير طلبك أو تجاهله.
موارد إضافية
- الفئات: #contribute:feature، #marketplace، #customization:plugin، #customization:extras، #customization:theme، Customization > 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
