कोर में योगदान दें

Blockly कोर रिपॉज़िटरी में वह कोड शामिल होता है, जो किसी भी Blockly-आधारित ऐप्लिकेशन को चलाने के लिए ज़रूरी होता है.

ज़रूरी जानकारी

यहां ब्लॉकली कोर से जुड़े उन तथ्यों के बारे में खास जानकारी दी गई है जिन्हें पीआर बनाने के लिए आपको जानना ज़रूरी है.

  • काम करने वाली शाखा डेवलप है और सभी पीआर, डेवलपमेंट के हिसाब से बनाए जाने चाहिए.
  • आपको अनुरोध की गई जानकारी के साथ पुल अनुरोध टेंप्लेट भरना होगा.
  • कोड, Google की TypeScript स्टाइल गाइड के मुताबिक होना चाहिए.
  • अपने कमिट मैसेज में कंवेंशनल कमिट का इस्तेमाल करें और अनुरोध के टाइटल पाएं.
  • उपयोगकर्ता को दिखने वाली स्ट्रिंग /msg/messages.js फ़ाइल में होनी चाहिए, ताकि उनका अनुवाद किया जा सके. दुनिया में 6% से कम लोग मूल रूप से अंग्रेज़ी बोलते हैं.
  • ब्लॉक पर मौजूद टेक्स्ट, आम तौर पर छोटे अक्षरों में होना चाहिए (जिस तरह ज़्यादातर प्रोग्रामिंग भाषाओं में मौजूद कीवर्ड की तरह होता है).
  • पुराने सिस्टम के साथ काम करने की सुविधा को बनाए रखें. ब्लॉकली ऐप्लिकेशन बहुत से मौजूद हैं. इसलिए, हर किसी को नुकसान न पहुंचाएं.

  • किसी भी नई कोड फ़ाइल के साथ Apache लाइसेंस v2.0 जोड़ा जाना ज़रूरी है:

    /**
 *   @license
 *   Copyright <Current YYYY> Google LLC
 *   SPDX-License-Identifier: Apache-2.0
 */

बदलाव करना और उसकी पुष्टि करना

  1. डिपेंडेंसी इंस्टॉल करने के लिए, npm install चलाएं.
  2. खेल के मैदान वाला सर्वर चालू करने के लिए, npm run start चलाएं. मौजूदा व्यवहार की जांच करने के लिए, इस पेज का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, playground पेज देखें.
  3. कोड में सभी ज़रूरी बदलाव करें.
  4. अगर आपने सर्वर को चालू छोड़ दिया है, तो अपने बदलाव देखने के लिए रीफ़्रेश करें. अगर ऐसा नहीं है, तो सर्वर को रीस्टार्ट करें और पुष्टि करें कि कोड उम्मीद के मुताबिक काम कर रहा है. साथ ही, कंसोल में कोई गड़बड़ी या चेतावनी नहीं है.
  5. npm run build चलाएं और पक्का करें कि बिल्ड से जुड़ी कोई गड़बड़ी न हो.
  6. ऑटोमेटेड टेस्ट के बारे में लिखें. आम तौर पर, tests/mocha डायरेक्ट्री में ये मोका टेस्ट होते हैं. हालांकि, हम आपसे दूसरी तरह की जांचों के लिए कह सकते हैं.
  7. कोड को फ़ॉर्मैट करने और लिंट से जुड़ी कुछ समस्याएं अपने-आप ठीक करने के लिए, npm run format चलाएं.
  8. अपने-आप होने वाले टेस्ट चलाने के लिए, npm test चलाएं. यह eslint को भी चलाता है.
  9. अगर लिंट से जुड़ी गड़बड़ियां हैं, तो उन समस्याओं को ठीक करने के लिए npm run lint:fix चलाएं जिन्हें अपने-आप ठीक किया जा सकता है. लिंट से जुड़ी बाकी चेतावनियों या गड़बड़ियों को ठीक करें.
  10. अगर सभी टेस्ट पास हो जाते हैं, तो आप अपने बदलावों के साथ डेवलप करने के लिए पीआर खोलने के लिए तैयार हैं.