طريقة المساهمة

نسعد بقبول تصحيحاتك ومساهماتك في هذا المشروع. هناك بعض الإرشادات الصغيرة التي يجب اتباعها.

اتفاقية ترخيص المساهمين

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

في العادة، لا تحتاج عادةً إلى إرسال اتفاقية ترخيص المحتوى سوى مرة واحدة، لذا إذا سبق أن أرسلتها (حتى لو كانت متعلّقة بمشروع مختلف)، لن تحتاج على الأرجح إلى إرسالها مرة أخرى.

إرسال رمز تصحيح

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

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

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

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

  5. أخيرًا، أرسِل الالتزامات إلى مفترق الطرق ثم أرسِل طلب سحب.