هل وجدت خطأ ما أو لديك فكرة عن ميزة جديدة رائعة؟ تعد المساهمة بالكود طريقة رائعة لرد الجميل لمجتمع المصادر المفتوحة. قبل أن تتعمق في الكود، هناك بعض الإرشادات التي يجب على المساهمين اتباعها حتى نتمكن من متابعة الأمور.
تأكد من أن لديك حساب JIRA.
تأكد من أن لديك حساب جيثب.
إذا كنت تخطط لتنفيذ ميزة جديدة، فمن المنطقي مناقشة تغييراتك في قائمة المطورين أولاً. بهذه الطريقة يمكنك التأكد من أنك لا تضيع وقتك على شيء لا يعتبر ضمن نطاق Apache Maven.
أرسل تذكرة لمشكلتك، على افتراض عدم وجودها بالفعل.
قم بوصف المشكلة بوضوح، بما في ذلك الخطوات اللازمة لإعادة إظهارها عندما تكون مشكلة.
تأكد من ملء الإصدار الأقدم الذي تعرف أنه يحتوي على المشكلة.
شوكة المستودع على جيثب.
نحن نقبل طلبات السحب عبر GitHub. القائمة البريدية للمطورين هي قناة الاتصال الرئيسية للمساهمين.
هناك بعض الإرشادات التي ستجعل تطبيق العلاقات العامة أسهل بالنسبة لنا:
قم بإنشاء فرع موضوع من المكان الذي تريد أن يرتكز عليه عملك (عادةً ما يكون هذا هو الفرع الرئيسي). ادفع تغييراتك إلى فرع الموضوع في شوكة المستودع الخاصة بك.
جعل الالتزامات من الوحدات المنطقية.
احترام نمط التعليمات البرمجية الأصلي: باستخدام نفس نمط التعليمات البرمجية، يجب أن تسلط التصحيحات الضوء فقط على الفرق الفعلي، دون الانزعاج من أي مشكلات في التنسيق:
استخدم المسافات البادئة فقط.
إنشاء الحد الأدنى من الاختلافات - قم بتعطيل إجراءات الحفظ مثل إعادة تنسيق كود المصدر أو تنظيم عمليات الاستيراد. إذا كنت تشعر أنه يجب إعادة تنسيق التعليمات البرمجية المصدر، فقم بإنشاء PR منفصل لهذا التغيير.
تحقق من وجود مسافة بيضاء غير ضرورية باستخدام git diff --check
قبل الالتزام.
تأكد من أن رسائل الالتزام الخاصة بك بالتنسيق الصحيح. يجب أن تحتوي رسالة الالتزام الخاصة بك على مفتاح مشكلة JIRA.
[MSHARED-XXX] - Subject of the JIRA Ticket Optional supplemental description.
تأكد من إضافة الاختبارات اللازمة (JUnit/IT) لتغييراتك.
قم بإجراء جميع الاختبارات باستخدام mvn -Prun-its verify
للتأكد من عدم تعرض أي شيء آخر للكسر عن طريق الخطأ.
أرسل طلب سحب إلى المستودع في مؤسسة Apache.
قم بتحديث تذكرة JIRA الخاصة بك وقم بتضمين رابط لطلب السحب في التذكرة.
إذا كنت تخطط للمساهمة على أساس منتظم، يرجى النظر في تقديم اتفاقية ترخيص المساهم.
بالنسبة للتغييرات ذات الطبيعة التافهة للتعليقات والوثائق، ليس من الضروري دائمًا إنشاء تذكرة جديدة في JIRA. في هذه الحالة، من المناسب أن يبدأ السطر الأول من الالتزام بـ '(doc)' بدلاً من رقم التذكرة.
بقع المساهمة
صفحة مشروع المكونات المشتركة لـ Apache Maven
اتفاقية ترخيص المساهم
وثائق جيثب العامة
وثائق طلب سحب GitHub
حساب أباتشي مافن على تويتر
قناة #Maven IRC على freenode.org