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