सबसे पहले, Bagel नेटवर्क में योगदान देने के लिए धन्यवाद! कृपया बेज़ल समुदाय के लिए, अपने प्रोजेक्ट और उसके सुझाए गए नाम को शेयर करने के लिए, baज़ेन-discuss ईमेल की सूची में शामिल करें.
अगर बैज से जुड़ा कोई टूल बनाया जा रहा है या Skylark के नियम शेयर किए जा रहे हैं, हमारा सुझाव है कि आप अपने प्रोजेक्ट के नाम के लिए, इन दिशा-निर्देशों का पालन करें:
स्टारलार्क के नियमों को नाम देना
Starlark के नए नियम लागू करने का तरीका देखें देखें.
Basel से जुड़े अन्य टूल को नाम देना
यह सेक्शन तब लागू होता है, जब आपको Basel नेटवर्क को बेहतर बनाने के लिए कोई टूल बनाना हो. उदाहरण के लिए, नया IDE प्लगिन या नया बिल्ड सिस्टम माइग्रेटर.
अपने टूल के लिए एक अच्छा नाम चुनना मुश्किल हो सकता है. अगर हम सावधानियां बरतते हैं और बेज़ल नेटवर्क को समझना बहुत मुश्किल हो सकता है. नए दर्शकों के लिए बनाया गया है.
बेज़ल टूल का नाम रखने के लिए, इन दिशा-निर्देशों का पालन करें:
नए ब्रैंड का नाम पेश नहीं करना: "बेज़ल" पहले से ही एक नया ब्रैंड है इसलिए, हमें उन्हें बहुत सारे नए नामों से भ्रमित करने से बचना चाहिए.
ऐसा नाम इस्तेमाल करना जिसमें "Ba" शामिल हो: इससे यह बताने में मदद मिलती है कि बेज़ल से संबंधित एक टूल है, यह सर्च इंजन के ज़रिए लोगों को इसे खोजने में भी मदद करता है.
टूल से जानकारी देने वाले नाम इस्तेमाल करें: आम तौर पर, लोगों के लिए इस नाम के सबटाइटल की ज़रूरत नहीं होनी चाहिए, ताकि वे पहले अच्छा अनुभव पा सकें अंदाज़ा लगाया कि टूल क्या करता है. अंग्रेज़ी शब्दों को खाली जगह से अलग करके इस्तेमाल करना अच्छा है एक नया तरीका है.
फूलों या खाने की थीम का इस्तेमाल करना ज़रूरी नहीं है: बेज़ेल का कहना है तुलसी, एक पौधा. आपको ये काम करने की ज़रूरत नहीं है कोई पौधा, भोजन या "तुलसी" से मिलता-जुलता नाम खोजो.
अगर आपका टूल किसी तीसरे पक्ष के ब्रैंड से जुड़ा है, तो इसका इस्तेमाल सिर्फ़ डिस्क्रिप्टर: उदाहरण के लिए, "सीमेक के लिए बैजल माइग्रेटर" इस्तेमाल करें के बजाय "सीमेक बेज़ल माइग्रेटर".
ये दिशा-निर्देश, GitHub के डेटा स्टोर करने की जगह के यूआरएल पर भी लागू होते हैं. डेटा स्टोर करने की जगह को पढ़ना यूआरएल से लोगों को यह समझने में मदद मिलनी चाहिए कि टूल क्या करता है. बेशक, रिपॉज़िटरी नाम छोटा हो सकता है और उसमें स्पेस और लोअर केस अक्षरों के बजाय डैश का उपयोग करना चाहिए.
अच्छे नामों के उदाहरण:
- Eclipse के लिए बेल: उपयोगकर्ता यह समझ लेंगे कि अगर वे Basel का इस्तेमाल करना चाहते हैं, तो एक्लिप्स के साथ, उन्हें यहां देखना चाहिए. यह किसी तीसरे पक्ष के ब्रैंड का इस्तेमाल करता है डिस्क्रिप्टर के तौर पर इस्तेमाल किया जाता है.
- बेज़ल बिल्डफ़ार्म: एक "बिल्डफ़ार्म" एक है कंपाइल फ़ार्म. लोग यह समझेगा कि यह प्रोजेक्ट, सर्वर पर बनाने से जुड़ा है.
ऐसे नामों के उदाहरण जिनसे बचना चाहिए:
- ओसिमम: तुलसी का वैज्ञानिक नाम Basel प्रोजेक्ट के लिए पर्याप्त रूप से संबंधित नहीं है.
- बेज़लाइज़र: इस नाम का टूल बहुत सारे काम कर सकता है, यह नाम है जानकारी पर्याप्त नहीं है.
ध्यान दें कि ये सुझाव दिशा-निर्देश Google किसी प्रोजेक्ट के लिए ओपन सोर्स का इस्तेमाल करता है.