लाइसेंस देने के लिए कानूनी समझौता
WebRTC में सुविधाओं और गड़बड़ियों को ठीक करने के लिए, पैच/पुल का स्वागत है!
Google से बाहर के योगदान देने वालों के लिए, Google Individual Contributor License Agreement में दिए गए निर्देशों का पालन करें. सभी मामलों में, योगदान को स्वीकार किए जाने से पहले, योगदान देने वाले को लाइसेंस देने के लिए कानूनी समझौते पर हस्ताक्षर करना होगा. कृपया व्यक्ति या कॉर्पोरेशन के लिए, ज़रूरत के हिसाब से कानूनी समझौता भरें.
सैंपल उपलब्ध कराना
अगर आपको कोई नया सैंपल जोड़ना है या किसी मौजूदा सैंपल में अहम बदलाव करने हैं, तो हमारा सुझाव है कि आप नई समस्या बनाएं. इसकी मदद से, हम समस्या के बारे में बातचीत कर पाएंगे.
नया सैंपल बनाते समय या किसी मौजूदा सैंपल को अपडेट करते समय, कृपया पक्का करें कि आपने टेस्ट भी बनाए हों या मौजूदा टेस्ट को अपडेट किया हो. उस रिपॉज़िटरी में मौजूद सभी टेस्ट, Nightwatch.JS यूज़र इंटरफ़ेस (यूआई) टेस्ट के तौर पर लागू किए गए हैं. इसलिए, कृपया अपने टेस्ट में भी यही डिज़ाइन अपनाएं.
निर्देश
अपना पहला पैच योगदान करना
अपना पहला सीएल अपलोड करने के लिए, आपको कुछ तैयारी करनी होगी:
- कोड को चेक आउट और बिल्ड करना
- योगदान देने वाले के कानूनी समझौते को भरें (ऊपर देखें)
- अगर आपने पहले कभी कोड सबमिट नहीं किया है, तो आपको AUTHORS फ़ाइल में अपना (या अगर योगदान देने वाले के समझौते पर आपके संगठन ने हस्ताक्षर किया है, तो अपने संगठन का) नाम और संपर्क जानकारी जोड़नी होगी
- https://webrtc.googlesource.com/new-password पर जाएं और अपने ईमेल खाते से लॉगिन करें. यह वही खाता होना चाहिए जो
git config user.emailसे मिला है - इसके बाद,
git cl creds-checkचलाएं. अगर आपको कोई गड़बड़ी मिलती है, तो discuss-webrtc पर मदद मांगें
आपको ऊपर बताई गई प्रोसेस दोहराने की ज़रूरत नहीं है. इसके बाद, वीडियो अपलोड करने के लिए तैयार हैं:
पहला पैच अपलोड करना
खाता सेट अप करने के बाद, वीडियो अपलोड किया जा सकता है:
यह करें:
- मान लें कि आप मुख्य शाखा पर हैं:
git checkout -b my-work-branch
बदलाव करना, स्थानीय तौर पर बनाना, और स्थानीय तौर पर टेस्ट करना
git commit -am "Changed x, and it is working"git cl upload
इससे एक टेक्स्ट एडिटर खुलेगा, जिसमें सभी लोकल कमिट मैसेज दिखेंगे. इससे, सीएल के ब्यौरे में बदलाव करने से पहले, उसमें बदलाव किया जा सकता है.
गड़बड़ी की जानकारी देने वाला फ़ॉर्म सही तरीके से भरें. कृपया समस्या ट्रैकर का प्रीफ़िक्स और समस्या नंबर डालें. इन दोनों को कोलन से अलग करें, जैसे कि
webrtc:123याchromium:12345. अगर आपके पास समस्या ट्रैकर का प्रीफ़िक्स और समस्या का नंबर नहीं है, तो सिर्फ़Noneजोड़ें.WebRTC के कोड की समीक्षा करने वाले सर्वर पर अपलोड करने के लिए, फ़ाइल को सेव करें और बंद करें.
अगर सब कुछ ठीक से हो जाता है, तो यह कमांड https://webrtc-review.googlesource.com/c/src/+/53121 जैसा लिंक प्रिंट करेगा.
- मान लें कि आप मुख्य शाखा पर हैं:
इस CL लिंक पर क्लिक करें
अगर आपने साइन इन नहीं किया है, तो सबसे ऊपर दाईं ओर मौजूद 'साइन इन करें' बटन पर क्लिक करें और अपने ईमेल पते से साइन इन करें
'समीक्षा शुरू करें' पर क्लिक करें और समीक्षक जोड़ें. समीक्षकों की जानकारी, रिपॉज़िटरी में मौजूद OWNERS फ़ाइलों में मिल सकती है. अपने बदलावों के आस-पास मौजूद फ़ाइल देखें
समीक्षक के सुझाव/राय या शिकायत का जवाब दें:
- बदलाव करना, स्थानीय तौर पर बनाना, स्थानीय तौर पर टेस्ट करना
git commit -am "Fixed X and Y"git cl upload
- बदलाव करना, स्थानीय तौर पर बनाना, स्थानीय तौर पर टेस्ट करना
जब समीक्षक पैच को LGTM (मंज़ूरी देता है), तो उसे कमिट करने की सूची में डालने के लिए कहें
सूचना: Windows पर, आपको ऊपर दिए गए निर्देशों को Git bash shell में चलाना होगा, ताकि gclient .gitcookies फ़ाइल ढूंढ सके.
Trybots
अगर WebRTC का ज़्यादा इस्तेमाल किया जा रहा है, तो ट्रायल के लिए उपलब्ध अधिकारों के लिए आवेदन किया जा सकता है. इसका मतलब है कि आपके पास trybots चलाने का विकल्प है. ये सभी प्लैटफ़ॉर्म पर सभी टेस्ट चलाते हैं. ऐसा करने के लिए, bugs.webrtc.org पर गड़बड़ी की शिकायत करें और EngProd टीम से, आपको आज़माने की अनुमति देने के लिए कहें.
ट्राइजॉब चलाने के लिए, ऊपर बताए गए तरीके से सीएल अपलोड करें. इसके बाद, CQ ड्राई रन या Gerrit यूज़र इंटरफ़ेस (यूआई) में Trybots चुनें पर क्लिक करें. इसके लिए, आपके पास आज़माने के अधिकार होने चाहिए. अगर ऐसा नहीं है, तो अपनी समीक्षा करने वाले व्यक्ति से कहें कि वह आपके लिए बॉट हटा दे.