Bazel से जुड़े प्रोजेक्ट को नाम देना

समस्या की शिकायत करें सोर्स देखें

सबसे पहले, Basel नेटवर्क में योगदान देने के लिए धन्यवाद! अपने प्रोजेक्ट और उसके सुझाए गए नाम को शेयर करने के लिए, bazu-discuss ईमेल सूची पर Basel समुदाय से संपर्क करें.

अगर आपको Basel से जुड़ा कोई टूल बनाना है या Skylark के अपने नियम शेयर करने हैं, तो हमारा सुझाव है कि आप अपने प्रोजेक्ट के नाम के लिए इन दिशा-निर्देशों का पालन करें:

स्टारलार्क के नियमों को नाम देना

Docs में, Starlark के नए नियम लागू करने का तरीका देखें.

यह सेक्शन तब लागू होता है, जब आपको Basel नेटवर्क को बेहतर बनाने के लिए कोई टूल बनाना हो. उदाहरण के लिए, नया IDE प्लगिन या नया बिल्ड सिस्टम माइग्रेटर.

अपने टूल के लिए एक अच्छा नाम चुनना मुश्किल हो सकता है. अगर हम सावधान नहीं रहते और कई कोडनेम इस्तेमाल करते हैं, तो आने वाले नए लोगों के लिए बेज़ेल नेटवर्क को समझना बहुत मुश्किल हो सकता है.

बेज़ल टूल का नाम रखने के लिए, इन दिशा-निर्देशों का पालन करें:

  1. किसी नए ब्रैंड का नाम पेश नहीं करना: "Bazel" हमारे उपयोगकर्ताओं के लिए पहले से ही एक नया ब्रैंड है. इसलिए, हमें उन्हें बहुत सारे नए नाम देने से बचना चाहिए.

  2. ऐसे नाम का इस्तेमाल करना पसंद करें जिसमें "Bazu" शामिल हो: इससे यह बताने में मदद मिलती है कि यह टूल Basel से जुड़ा हुआ है. साथ ही, इससे लोगों को सर्च इंजन में उसे खोजने में भी मदद मिलती है.

  3. टूल से जुड़े काम के बारे में जानकारी देने वाले नामों का इस्तेमाल करना: आम तौर पर, उपयोगकर्ताओं को यह पता लगाने के लिए कि टूल क्या काम कर रहा है, नाम के लिए सबटाइटल की ज़रूरत नहीं होनी चाहिए. अंग्रेज़ी के शब्दों को खाली जगह से अलग करके इस्तेमाल करना, इसका एक अच्छा तरीका है.

  4. फूलों या खाने की थीम इस्तेमाल करने की ज़रूरत नहीं है: बेज़ल तुलसी जैसे पौधे को जन्म देता है. आपको किसी पौधे, भोजन या "तुलसी" से मिलता-जुलता नाम खोजने की ज़रूरत नहीं है.

  5. अगर आपका टूल तीसरे पक्ष के किसी अन्य ब्रैंड से जुड़ा है, तो उसका इस्तेमाल सिर्फ़ जानकारी देने वाले के तौर पर करें: उदाहरण के लिए, "Cmake Bagel migrator" के बजाय "Cmake के लिए बैजल माइग्रेटर" का इस्तेमाल करें.

ये दिशा-निर्देश, GitHub के डेटा स्टोर करने की जगह के यूआरएल पर भी लागू होते हैं. रिपॉज़िटरी के यूआरएल को पढ़ने से लोगों को यह समझने में मदद मिलती है कि टूल क्या करता है. हालांकि, रिपॉज़िटरी का नाम छोटा हो सकता है. इसलिए, इसमें स्पेस और लोअर केस अक्षरों के बजाय, डैश का इस्तेमाल करना ज़रूरी है.

अच्छे नामों के उदाहरण:

  • एक्लिप्स के लिए बेल: उपयोगकर्ता यह समझ पाएंगे कि अगर वे Eclipse के साथ Basel का उपयोग करना चाहते हैं, तो उन्हें यहां देखना चाहिए. इसमें डिस्क्रिप्टर के तौर पर तीसरे पक्ष के ब्रैंड का इस्तेमाल किया गया है.
  • बेज़ल बिल्डफ़ार्म: "बिल्डफ़ार्म" एक कंपाइल फ़ार्म होता है. उपयोगकर्ता समझ पाएंगे कि यह प्रोजेक्ट, सर्वर पर बनाने से जुड़ा है.

ऐसे नामों के उदाहरण जिनसे बचना चाहिए:

  • ओसिमम: तुलसी का वैज्ञानिक नाम बेज़ल प्रोजेक्ट से मिलता-जुलता नहीं है.
  • बेज़लाइज़र: इस नाम के पीछे का टूल बहुत सारे काम कर सकता है, इस नाम से बहुत ज़्यादा जानकारी नहीं मिलती है.

ध्यान दें कि ये सुझाव उन दिशा-निर्देशों के मुताबिक हैं जिनका इस्तेमाल Google किसी प्रोजेक्ट को ओपन सोर्स करते समय करता है.