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