نشكرك أولاً على المساهمة في منظومة Bazel المتكاملة. يُرجى التواصل مع منتدى Bazel من خلال القائمة البريدية لمناقشة Bazel لمشاركة مشروعك واسمه المقترح.
إذا كنت بصدد إنشاء أداة مرتبطة بـ Bazel أو مشاركة قواعد Skylark، يُرجى اتّباع الإرشادات التالية لاسم مشروعك:
تسمية قواعد Starlark
راجِع نشر قواعد Starlark جديدة في المستندات.
تسمية الأدوات الأخرى ذات الصلة بخدمة Bazel
ينطبق هذا القسم في حال كنت تنشئ أداة لإثراء منظومة Bazel المتكاملة. على سبيل المثال، مكوّن إضافي جديد لـ IDE أو أداة ترحيل نظام الإصدار الجديدة.
قد يكون اختيار اسم جيد لأداتك أمر صعب. وإذا لم نكن حذرين ونستخدِم عددًا كبيرًا من أسماء الرموز، قد يصبح من الصعب فهم منظومة Bazel المتكاملة بالنسبة إلى المستخدمين الجدد.
اتّبع هذه الإرشادات لتسمية أدوات Bazel:
أفضِّل عدم تقديم اسم علامة تجارية جديد: "Bazel" هي علامة تجارية جديدة للمستخدمين، لتجنُّب الخلط بينها وبين أسماء جديدة جدًا.
أفضِّل استخدام اسم يتضمن "Bazel": يساعد هذا على التعبير عن أنه أداة مرتبطة بـ Bazel، كما يساعد الأشخاص في العثور عليه باستخدام محرك بحث.
تفضيل استخدام أسماء تصف ما تفعله الأداة: من الأفضل أن لا يكون الاسم بحاجة إلى عنوان فرعي حتى يحصل المستخدمون على أول تخمين جيّد حول ما تفعله الأداة. ويُعد استخدام الكلمات الإنجليزية مفصولة بمسافات طريقة جيدة لتحقيق ذلك.
لست بحاجة إلى استخدام مظهر الأزهار أو الأطعمة: يستدعي "بازيل" النبات الريح. ولست بحاجة إلى البحث عن اسم نباتي أو طعام أو متعلق بـ "الريحان".
إذا كانت الأداة مرتبطة بعلامة تجارية أخرى تابعة لجهة خارجية، استخدِمها فقط كوصف للوصف: على سبيل المثال، استخدِم "مُهاجع البازل لـ Cmake" بدلاً من "مُهاجِرة بازيل".
تسري هذه الإرشادات أيضًا على عنوان URL لمستودع GitHub. وتساعد قراءة عنوان URL الخاص بالمستودع الأشخاص في التعرّف على وظائف الأداة. بطبيعة الحال، قد يكون اسم المستودع أقصر ويجب أن يستخدم الشرطات بدلاً من المسافات والحروف الصغيرة.
أمثلة على الأسماء الجيدة:
- Bazel for Eclipse: سيدرك المستخدمون أنّهم إذا أرادوا استخدام Bazel مع Eclipse، يجب أن يهتموا بالبحث عنه. وهي تستخدم علامة تجارية لطرف ثالث كوصف.
- البازيلم البناء: "البنية" هي مزرعة مجمّعة. سيدرك المستخدمون أن هذا المشروع مرتبط بالإنشاء على الخوادم.
أمثلة على الأسماء التي يجب تجنّبها:
- الأوكيمو: الاسم العلمي لأوراق الريحان لا يرتبط بما فيه الكفاية لمشروع بازيل.
- Bazelizer: يمكن أن تؤدي الأداة التي تحمل هذا الاسم الكثير من الأمور، ولكن هذا الاسم غير وصفي بما يكفي.
وتجدر الإشارة إلى أنّ هذه الاقتراحات تتوافق مع الإرشادات التي تستخدمها Google عند إصدار مشروع مفتوح المصدر.