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