Blockly में योगदान देना शुरू करना

Blockly एक ओपन सोर्स है और इसका रखरखाव मुख्य रूप से एक छोटी टीम करती है. हम कोर टीम से बाहर के डेवलपर के योगदान का स्वागत करते हैं. हमारी कम्यूनिटी के बिना, हम हर अनुरोध की गई सुविधा को नहीं बना सकते या हर रिपोर्ट किए गए बग को ठीक नहीं कर सकते. इस सेक्शन में सामान्य गाइड दी गई हैं. ये आपके लिए मददगार हो सकती हैं. खास तौर पर, अगर आपने ओपन सोर्स डेवलपमेंट में नया काम शुरू किया है.

Blockly से जुड़ी जानकारी के लिए, कोर में योगदान करना और सैंपल में योगदान करना सेक्शन देखें. आपको योगदान करने से पहले यह जानकारी पढ़नी चाहिए.

कौनसी रिपॉज़िटरी?

रिपॉज़िटरी में, किसी एक प्रोजेक्ट की सभी फ़ाइलें होती हैं. Blockly की दो रिपॉज़िटरी हैं: blockly core और blockly-samples.

Blockly core, Blockly लाइब्रेरी के लिए रिपॉज़िटरी है. अगर आपको Blockly के मुख्य व्यवहार में ऐसा बदलाव करना है जो लाइब्रेरी के सभी उपयोगकर्ताओं पर लागू होगा, तो इस रिपॉज़िटरी का इस्तेमाल करें.

Blockly के सैंपल, सैंपल, प्लगिन, और कोडलैब के लिए रिपॉज़िटरी है. अगर आपको कोई प्लगिन बनाना है या उसमें बदलाव करना है, कोडलैब लिखना है या कोई सैंपल बनाना है या उसमें बदलाव करना है, तो इस रिपॉज़िटरी का इस्तेमाल करें.

चरण दर चरण

जब भी कोई बदलाव किया जाएगा, तब आपको ये सामान्य चरण पूरे करने होंगे.

1. टूल सेक्शन में दिए गए लिंक का इस्तेमाल करके, Git और Node इंस्टॉल करें.
2. रिपॉज़िटरी को फ़ोर्क और क्लोन करें. GitHub पर, किसी रिपॉज़िटरी को फ़ोर्क करने के बारे में एक बेहतरीन ट्यूटोरियल उपलब्ध है. इसे Blockly पर लागू करने के लिए, octocat/Spoon-Knife के हर इंस्टेंस को RaspberryPiFoundation/blockly या RaspberryPiFoundation/blockly-samples से बदलें. यह इस बात पर निर्भर करता है कि आपको किस रिपॉज़िटरी में काम करना है.
3. अपने फ़ोर्क किए गए वर्शन को सिंक करें. GitHub, फ़ोर्क को सिंक करने के लिए भी एक ट्यूटोरियल उपलब्ध कराता है.
4. मुख्य ब्रांच देखें. Blockly Core में, यह develop ब्रांच है. blockly-samples में यह master ब्रांच है.
5. रूट डायरेक्ट्री में npm install चलाकर, डिपेंडेंसी और बिल्ड टूल इंस्टॉल करें.
6. टर्मिनल में git checkout -b myBranchName चलाकर, नई ब्रांच बनाएं. नाम ऐसा होना चाहिए जिससे आपको याद रहे कि आपको किस पर काम करना है.
7. बदलाव करें.
8. अपने बदलावों की पुष्टि करें. इसके लिए,कोर या सैंपल से जुड़ी गाइड का पालन करें.
9. git commit -am "fix: My commit message" की मदद से, अपने बदलाव सेव करें. कमिट मैसेज के बारे में ज़्यादा जानें.
10. git push origin myBranchName की मदद से, अपने बदलावों को GitHub पर पुश करें.
11. कोड तैयार होने पर, पुल अनुरोध खोलें. Blockly टीम का एक सदस्य आपके बदलावों की समीक्षा करेगा. अगर उन्हें मंज़ूरी मिल जाती है, तो उन्हें Blockly में मर्ज कर दिया जाएगा. ज़्यादा जानकारी के लिए, पीआर की समीक्षा करने की प्रोसेस लेख पढ़ें.