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

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

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

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

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

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

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

चरण दर चरण

किसी भी समय बदलाव करने के लिए, ये सामान्य तरीके अपनाएं.

1. टूल सेक्शन में दिए गए लिंक का इस्तेमाल करके, Git और Node इंस्टॉल करें.
2. रिपॉज़िटरी को फ़ॉर्क और क्लोन करें. GitHub पर, किसी रिपॉज़िटरी को फ़ॉर्क करने के बारे में एक बेहतरीन ट्यूटोरियल मौजूद है. इसे Blockly में लागू करने के लिए, octocat/Spoon-Knife के हर इंस्टेंस को google/blockly या google/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 में मर्ज कर देगा. ज़्यादा जानकारी के लिए, पीआर की समीक्षा की प्रोसेस लेख पढ़ें.