सुझाए गए नियम

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

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

नॉमिनेशन

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

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

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

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

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

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

कॉन्टेंट को नतीजों के क्रम वाली सूची में नीचे भेजना

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

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