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