दस्तावेज़ में, हमने सुझाए गए नियमों की सूची दी है.
यह अच्छी क्वालिटी वाले नियमों का सेट है. इससे हमारे उपयोगकर्ताओं को बेहतर अनुभव मिलेगा. हम उन नियमों के बीच अंतर करते हैं जो काम करते हैं और वे सैकड़ों नियम जो आपको इंटरनेट पर मिल सकते हैं.
नॉमिनेशन
Bazel की मुख्य टीम की समीक्षा के बाद, इसे Bazel की वेबसाइट पर सुझाया जाएगा.
नियमों को बनाए रखने वाले लोगों के लिए ज़रूरी शर्तें
- नियम सेट, एक अहम सुविधा देता है. यह सुविधा, Bazel के ज़्यादातर उपयोगकर्ताओं के लिए काम की होती है. उदाहरण के लिए, किसी लोकप्रिय भाषा के लिए सहायता.
- नियम सेट का रखरखाव अच्छी तरह से किया जाता है. कम से कम दो लोग, नियमों को बनाए रखने वाले होने चाहिए.
- नियम सेट के बारे में अच्छी तरह से बताया गया हो. साथ ही, उसमें उदाहरण दिए गए हों और वह इस्तेमाल करने में आसान हो.
- नियम सेट, सबसे सही तरीकों का पालन करता हो और उसकी परफ़ॉर्मेंस अच्छी हो. परफ़ॉर्मेंस के बारे में जानकारी देने वाली गाइड देखें (the performance guide).
- नियम सेट की टेस्ट कवरेज अच्छी हो.
- नियम सेट को BuildKite पर, Bazel के नए वर्शन के साथ टेस्ट किया गया हो. टेस्ट हमेशा पास होने चाहिए. ऐसा तब होना चाहिए, जब इनका इस्तेमाल सबमिट करने से पहले की जाने वाली जांच के तौर पर किया जाता है.
- नियम सेट को, आने वाले समय में होने वाले उन बदलावों के साथ भी टेस्ट किया जाता है जो काम नहीं करेंगे. दो हफ़्तों के अंदर, गड़बड़ियों को ठीक किया जाना चाहिए. माइग्रेशन से जुड़ी समस्याओं के बारे में, Bazel की टीम को तुरंत सूचना दी जानी चाहिए.
Bazel के डेवलपर के लिए ज़रूरी शर्तें
- सुझाए गए नियमों को, Bazel के नए वर्शन के साथ अक्सर टेस्ट किया जाता है. ऐसा कम से कम दिन में एक बार किया जाता है.
- Bazel में किए गए किसी भी बदलाव की वजह से, सुझाया गया कोई नियम काम करना बंद नहीं करना चाहिए. ऐसा तब होना चाहिए, जब फ़्लैग के डिफ़ॉल्ट सेट का इस्तेमाल किया जा रहा हो. अगर ऐसा होता है, तो बदलाव को ठीक किया जाना चाहिए या उसे वापस लाया जाना चाहिए.
कॉन्टेंट को नतीजों के क्रम वाली सूची में नीचे भेजना
अगर आपको लगता है कि कोई नियम सेट, अब ज़रूरी शर्तों को पूरा नहीं कर रहा है, तो GitHub पर समस्या की शिकायत करें.
नियमों को बनाए रखने वाले लोगों से संपर्क किया जाएगा और उन्हें दो हफ़्तों में जवाब देना होगा. नतीजों के आधार पर, Bazel की मुख्य टीम, नियम सेट को नतीजों के क्रम वाली सूची में नीचे भेजने का फ़ैसला ले सकती है.