सैंपल में योगदान दें

Blockly के सैंपल में, Blockly से जुड़ा ऐसा कॉन्टेंट होता है जो मुख्य रिपॉज़िटरी का हिस्सा नहीं है. इसमें प्लग इन, कोडलैब, और उदाहरण के तौर पर दिया गया कोड शामिल है. इनमें से हर एक के बारे में ज़्यादा जानकारी के लिए, रिपॉज़िटरी का स्ट्रक्चर पेज देखें.

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

यहां blockly-samples के बारे में खास जानकारी दी गई है. इसे जानना, पीआर बनाने के लिए ज़रूरी है.

• काम करने वाली ब्रांच मास्टर है और सभी पीआर, मास्टर के आधार पर बनाए जाने चाहिए.
• npm install को अलग-अलग प्लग इन लेवल पर नहीं,बल्कि blockly-samples के रूट लेवल पर चलाएं. Blockly-samples एक मोनोरेपो है. इसका मतलब है कि इसमें एक ही रिपॉज़िटरी में कई पैकेज होते हैं. साथ ही, इसे रूट लेवल पर इंस्टॉल करना, Lerna की मदद से मोनोरेपो को मैनेज करने के वर्कफ़्लो का हिस्सा है.
• कोड, इस्तेमाल की गई भाषा के आधार पर, Google की JavaScript स्टाइल गाइड या TypeScript स्टाइल गाइड के मुताबिक होना चाहिए.
• अपने कमिट मैसेज और पुल रिक्वेस्ट के टाइटल में, कन्वेंशनल कमिट का इस्तेमाल करें.

• किसी भी नई कोड फ़ाइल के नाम में, Apache License v2.0 का प्रीफ़िक्स होना चाहिए:

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

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

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