ملخص
يغطي موضوع التوثيق هذا كتابة طلب ميزة في Discourse: دليل خطوة بخطوة.
الخطوة 1: قبل البدء
إذًا، لديك فكرة رائعة لميزة في Discourse؟ هذا رائع! إليك كيفية مشاركتها مع الفريق والمجتمع بفعالية. قبل تقديم طلب ميزة، يرجى أخذ لحظة للبحث في المناقشات الحالية لمعرفة ما إذا كانت فكرتك قد تم اقتراحها أو تنفيذها بالفعل. يمكنك القيام بذلك بعدة طرق:
- البحث في فئة Feature
- النقر على أيقونة
في الزاوية اليمنى العليا من الصفحة للوصول إلى البحث. يمكنك استخدام عوامل تصفية متقدمة للتصفية حسب الفئة والعلامة. - البحث في المواضيع التي تحمل العلامة pr-welcome - PR هو طلب سحب على GitHub - طريقة للمطورين لتقديم رمز جديد لمشروع.
- البحث في المواضيع التي تحمل العلامة completed
- البحث في فئة Plugin
إذا كان اقتراح الميزة الخاص بك مدرجًا بالفعل، يمكنك دعمه عن طريق التصويت عليه لزيادة بروز طلباتهم، والإعجاب به، والرد بأفكار إضافية أو حالات استخدام، لزيادة توضيح فائدته ولماذا يجب إضافة الميزة.
هل لم تجد أي ذكر لفكرتك؟ يمكنك إنشاء طلب ميزة.
الخطوة 2: الأساسيات
العنوان
من المهم أن تكون عناوين المواضيع مفيدة، ولكن في نفس الوقت ليست طويلة جدًا. يجب أن يكون نطاق الطلب قابلاً للتعرف عليه بسهولة بنظرة واحدة.
الفئة
عند إنشاء موضوع جديد، يرجى تحديد فئة Feature.
العلامة
تُستخدم العلامات لتجميع وتصنيف الميزات، لذلك، للحفاظ على تنظيم الطلبات، فإن وضع علامة مناسبة على موضوعك مفيد جدًا لأغراض التتبع. على سبيل المثال، يتم تجميع كل ما يتعلق بمكون الإضافات chat تحت علامة واحدة.
الخطوة 3: كتابة طلبك
تعد كتابة طلب ميزة جيد أمرًا مهمًا، فهو يساعد فريق Discourse على تحديد المجالات التي قد تحتاج إلى تحسين بسرعة.
تذكر، عند إنشاء طلب ميزة، فإنك تحاول تقديم فكرتك وإقناع الناس بأن فكرتك لميزة لها ما يبررها. اشرح لماذا تريد إضافة ميزتك إلى: المجتمع، ونفسك، والفريق.
في نص موضوعك، اذكر بإيجاز الميزة التي تطلبها. كن محددًا ووصفًا، وتجنب الغموض أو النهايات المفتوحة.
توفير السياق والشرح
وفر السياق والشرح لطلب الميزة الخاص بك.
- وصف واضح للميزة التي تطلبها
- قم بتضمين المشكلة أو حالات الاستخدام لصعوباتك الحالية وكيف ستحلها ميزتك
- أي معلومات خلفية ذات صلة أو بحث قمت به
توفير أمثلة ولقطات شاشة (اختياري)
إذا كان ذلك ممكنًا، قم بتوفير أمثلة أو نماذج أولية أو لقطات شاشة للمساعدة في توضيح طلب الميزة الخاص بك حتى يتمكن الآخرون من تصور فكرتك بسهولة.
التفاعل مع المجتمع
بمجرد إنشاء طلب الميزة الخاص بك، تفاعل مع الأعضاء عن طريق الرد على الأسئلة والملاحظات. سيساعد هذا في زيادة فرص النظر في طلبك.
ماذا تتوقع بعد ذلك
بعد تقديم طلب الميزة الخاص بك، سيتم مراجعته من قبل المجتمع وفريق Discourse. يمكنك توقع:
- ملاحظات ومناقشات من المجتمع
- رد من موظفي Discourse يشير إلى ما إذا كان طلبك قابلاً للتنفيذ قيد المراجعة
- التنفيذ المحتمل لميزة طلبك في تحديث مستقبلي
هل تريد التأكد من أن ميزتك سيتم إنشاؤها؟
في بعض الحالات، قد لا تكون طلبات الميزات مناسبة للنواة. يمكنك قراءة كيفية اتخاذ قرارات الميزات. إذا لم تتمكن من تطوير الميزة بنفسك، فلا تزال هناك طرق لزيادة فرص إنشائها.
كن عميلاً لـ discourse.org
إذا كنت ترغب في تمويل التطوير عن طريق استضافة مواقع معنا - فنحن نعطي دائمًا الأولوية لطلبات العملاء في جدولنا الزمني للتطوير - فهذه طريقة واحدة لتسريعها. يمكن لـ عملاء المؤسسات طلب ميزات مخصصة (عادةً في شكل مكون إضافي) من الفريق الأساسي بسعر بالساعة.
رعاية مهمة “pr-welcome”
لدينا قائمة شاملة بمواضيع pr-welcome. هذه مهام نود أن نراها مكتملة، ولكن ليس لدينا حاليًا النطاق الترددي للعمل عليها بأنفسنا. رعاية شخص ما للعمل على هذه المهام هي طريقة رائعة للمشاركة وأي مساهمة في Discourse محل تقدير كبير.
عرض عمل مدفوع في السوق
إذا كانت هناك مكون إضافي تحتاجه وهو أمر بالغ الأهمية لعملك، فقم بالإعلان عن مهمة مدفوعة في فئة Marketplace. قدم أكبر قدر ممكن من التفاصيل، بما في ذلك لقطات الشاشة والميزانية. قد تجد أيضًا مستقلين يقدمون خدمات مصغرة قياسية مثل “التثبيت لمرة واحدة” أو “السمة المخصصة”.
بشكل عام
الإيجابيات والسلبيات العامة
افعل
- حافظ على طلبك موجزًا وركز على ميزة واحدة
- تجنب وضع افتراضات حول التنفيذ أو التفاصيل الفنية
- أظهر الاستعداد للتنازل وتكييف فكرتك بناءً على ملاحظات المجتمع
لا تفعل
- قم بتضمين أكثر من ميزة واحدة لكل موضوع
- اترك الآخرين يتساءلون عن نطاق طلبك
الأسئلة الشائعة
س: ماذا لو لم يكن لدي وقت لإنشاء طلب ميزة مفصل؟
ج: إذا لم تكن قادرًا في الوقت الحالي على إنشاء طلب مفصل، ففكر فيما تريد قوله وحاول مرة أخرى لاحقًا. هذا يضمن أنك تقدم أفضل حالة لديك، مما يؤدي إلى فرصة أكبر لأن يدعم الآخرون طلبك وسيتم إضافته.
س: أين يجب أن أنشر طلب الميزة الخاص بي؟
ج: استخدم الفئة المناسبة - يجب أن تذهب طلبات الميزات إلى فئة Feature.
س: ماذا لو لم أكن متأكدًا من العلامة التي يجب استخدامها لطلبي؟
ج: على الرغم من أن العلامات تتطابق مع أسماء المكونات الإضافية ومكونات السمات لسهولة الاستخدام، سيقوم عضو في الفريق أو منتظم بإلحاق علامة مناسبة بموضوعك إذا ترك فارغًا.
كن محترمًا ومنفتحًا في طلبك. تجنب استخدام طلب الميزة للتعبير عن الإحباط. قد يؤدي أي لغة أو سلوك غير لائق إلى تأخير طلبك أو تجاهله.
موارد إضافية
- Feature - Discourse Meta
- Plugin - Discourse Meta
- 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
- Marketplace - Discourse Meta
- https://meta.discourse.org/c/releases
- Upcoming feature to-do list
- مواضيع تحمل علامة planned
- Extras - Discourse Meta
