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