تشرح هذه الصفحة الطرق التي يمكن من خلالها للمساهمين اقتراح قاعدة رمز Bazel وإجراء تغييرات عليها.
- اقرأ سياسة مساهمة البازل.
- يمكنك إنشاء مشكلة في GitHub لمناقشة خطتك وتصميمك. تحتاج طلبات السحب التي تؤدي إلى تغيير السلوك أو إضافتها إلى مشكلة مقابلة بشأن التتبُّع.
- إذا كنت تقترح تغييرات مهمة، اكتب مستند تصميم.
- احرص على توقيع اتفاقية ترخيص المساهم.
- جهّز التزامًا رسميًا ينفّذ الميزة. لا تنسَ إضافة الاختبارات وتعديل المستندات. إذا كان التغيير الذي أجريته له تأثيرات مرئية للمستخدم، يُرجى إضافة ملاحظات الإصدار. وإذا كان التغيير غير متوافق، اقرأ دليل طرح التغييرات التي قد تؤدي إلى أعطال.
- يمكنك إنشاء طلب سحب على GitHub. إذا كنت مبتدئًا في استخدام GitHub، اقرأ لمحة عن طلبات السحب. يُرجى العِلم أنّنا نحظر الأذونات لإنشاء فروع في مستودع Bazel الرئيسي، لذلك عليك دفع التزامك إلى مستودعك الخاص بالمستودع.
- من المفترض أن تخصص لك موظف في Bazel مُراجعًا في غضون يومَي عمل (باستثناء العطلات في الولايات المتحدة وألمانيا). وإذا لم يتم إسناد مراجعة إليك في ذلك الوقت، يمكنك طلب المراجعة من خلال إرسال رسالة إلكترونية إلى bazel-dev@googlegroups.com.
- عليك العمل مع المُراجع لإكمال مراجعة الرمز. مع كل تغيير، يمكنك إنشاء التزام جديد وادفعه لإجراء تغييرات على طلب السحب. وإذا استغرقت المراجعة وقتًا طويلاً (على سبيل المثال، إذا كان المُراجع لا يستجيب)، أرسِل رسالة إلكترونية إلى bazel-dev@googlegroups.com.
بعد اكتمال المراجعة، يطبق تطبيق Bazel رمز التصحيح على نظام التحكّم في الإصدارات الداخلية من Google.
ويؤدي ذلك إلى تشغيل عمليات فحص ما قبل الإرسال الداخلي التي قد تقترح المزيد من التغييرات. إذا لم تُفضّل التعبير عن تفضيلك، يضيف المشرف الذي يرسل التغيير الذي أجريته تغييرًا&عرضي، أي تغييرات (مثل الربط) لا تؤثر في التصميم. وإذا كانت هناك تغييرات أعمق مطلوبة أو كنت تفضّل تطبيق التغييرات مباشرةً، يجب أن تقدّم أنت أنت والمُراجع الإعدادات المفضّلة بوضوح في تعليقات المراجعة.
بعد الإرسال الداخلي، يتم تصدير رمز التصحيح كإتمام Git، عندها يتم إغلاق طلب سحب GitHub. تُنسَب جميع التغييرات النهائية إليك.