सुझाए गए नियम

दस्तावेज़ में, हमने सुझाए गए नियमों की सूची दी है.

यह अच्छी क्वालिटी वाले नियमों का एक सेट है. इससे हमारे उपयोगकर्ताओं को बेहतर अनुभव मिलेगा. हम उन नियमों के बीच अंतर करते हैं जो काम करते हैं और इंटरनेट पर मौजूद सैकड़ों नियमों के बीच अंतर करते हैं.

नॉमिनेशन

अगर कोई नियम सेट, ज़रूरी शर्तों को पूरा करता है, तो नियम को बनाए रखने वाला व्यक्ति, उसे सुझाए गए नियमों में शामिल करने के लिए नॉमिनेट कर सकता है. इसके लिए, उसे GitHub पर समस्या की शिकायत करनी होगी.

Bazel की कोर टीम की समीक्षा के बाद, इसे Bazel की वेबसाइट पर सुझाया जाएगा.

नियमों को बनाए रखने वालों के लिए ज़रूरी शर्तें

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

Bazel डेवलपर के लिए ज़रूरी शर्तें

• सुझाई गई नियमों की जांच, Bazel के साथ अक्सर की जाती है. ऐसा कम से कम दिन में एक बार किया जाता है.
• Bazel में कोई बदलाव न होने पर, सुझाया गया कोई नियम (फ़्लैग के डिफ़ॉल्ट सेट के साथ) काम नहीं कर सकता. अगर ऐसा होता है, तो बदलाव को ठीक किया जाना चाहिए या पहले जैसा कर देना चाहिए.

पदावनति

अगर आपको लगता है कि कोई खास नियम अब ज़रूरी शर्तों को पूरा नहीं कर रहा है, तो GitHub पर समस्या की शिकायत करें.

नियमों को बनाए रखने वालों से संपर्क किया जाएगा. उन्हें दो हफ़्तों के अंदर जवाब देना होगा. नतीजे के आधार पर, Bazel की कोर टीम, नियम के सेट को डिमोट करने का फ़ैसला ले सकती है.