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