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