WebRTC प्रोजेक्ट में योगदान देना

लाइसेंस के लिए कानूनी समझौता

WebRTC में सुविधाओं/गड़बड़ी को ठीक करने के लिए, पैच/पुल का इस्तेमाल किया जाता है!

Google से बाहर के योगदान देने वाले लोगों के लिए, Google Individual Contributor लाइसेंस कानूनी समझौते में दिए गए निर्देशों का पालन करें. सभी स्थितियों में, योगदान देने वाले को योगदान स्वीकार करने से पहले योगदान देने वाले के लाइसेंस के लिए कानूनी समझौते पर हस्ताक्षर करना होगा. कृपया सही व्यक्ति के तौर पर किसी या कॉर्पोरेशन के लिए समझौते को पूरा करें.

योगदान करने वाले नमूने

अगर आपको कोई नया नमूना जोड़ना है या किसी मौजूदा नमूने में अहम बदलाव करना है, तो हमारा सुझाव है कि आप नई समस्या बनाकर शुरुआत करें. यहां हम इस बारे में चर्चा कर सकते हैं.

नया नमूना बनाते समय या मौजूदा नमूना अपडेट करते समय, कृपया पक्का करें कि आप मौजूदा जांच भी बनाएं या अपडेट करें. उस रिपॉज़िटरी में मौजूद सभी टेस्ट नाइटवॉच.JS यूज़र इंटरफ़ेस (यूआई) टेस्ट के तौर पर लागू किए जाते हैं. इसलिए, कृपया उसी डिज़ाइन का पालन करें जो आप खुद बनाते हैं.

निर्देश

आपका पहला पैच शेयर करना

अपना पहला सीएल अपलोड करने के लिए आपको कुछ तैयारी करनी होगी:

  • चेक आउट करना और कोड बनाना
  • Contributor का कानूनी समझौता भरें (ऊपर देखें)
  • अगर आपने पहले कभी कोई कोड सबमिट नहीं किया है, तो आपको अपने संगठन का नाम और संपर्क जानकारी को AUTHORS फ़ाइल में जोड़ना होगा. अगर आपके संगठन के पास कानूनी समझौते पर योगदान देने वाले व्यक्ति का हस्ताक्षर है, तो आपको उसे जोड़ना होगा.
  • https://webrtc.googlesource.com/new-password पर जाएं और अपने ईमेल खाते से लॉगिन करें. यह वही खाता होना चाहिए जो git config user.email ने लौटाया है
  • इसके बाद: git cl creds-check चलाएं. अगर आपको कोई गड़बड़ी मिलती है, तो चर्चा-वेबसाइट पर मदद मांगें

आपको ऊपर दिया गया काम दोहराने की ज़रूरत नहीं है. इसके बाद, आप अपलोड करने के लिए तैयार हैं:

अपना पहला पैच अपलोड करना

अब जब आपने अपना खाता सेट अप कर लिया है, तो आप वास्तविक अपलोड कर सकते हैं:

  • यह करें:

    • मान लें कि आप मुख्य ब्रांच पर हैं&l:
      • git checkout -b my-work-branch
    • स्थानीय तौर पर टेस्ट करें, बदलावों के लिए टेस्ट करें

      • git commit -am "Changed x, and it is working"
      • git cl upload

      ऐसा करने पर एक टेक्स्ट एडिटर खुल जाएगा, जिसमें सीएल की जानकारी बनने से पहले, आप सभी स्थानीय Google Messages मैसेज में बदलाव कर सकते हैं.

      गड़बड़ी की जानकारी सही तरीके से भरें. कृपया समस्या को ट्रैक करने वाले प्रीफ़िक्स और समस्या को बताएं. इन्हें कोलन से अलग करें, जैसे कि 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
  • समीक्षक के जीटीएम (GTM) को पैच को मंज़ूरी देने के बाद, उन्हें उन्हें सूची में शामिल करने के लिए कहें

ध्यान दें: Windows पर, gclient की मदद के लिए आपको ऊपर दिए गए उदाहरण को एक GIF बैश शेल में चलाना होगा, ताकि gclient .gitcookies फ़ाइल ढूंढ सके.

ट्रायबॉट

अगर आप WebRTC में बहुत ज़्यादा काम कर रहे हैं, तो आप अधिकारों के बारे में जानने के लिए आवेदन कर सकते हैं. इसका मतलब है कि आप ट्रायबॉट चला सकते हैं, जो सभी प्लैटफ़ॉर्म पर सभी टेस्ट चलाते हैं. ऐसा करने के लिए, bug.webrtc.org पर गड़बड़ी की शिकायत करें और EngProd टीम से आपको कोशिश करने के अधिकार देने के लिए कहें.

कोई जॉब आज़माने के लिए, ऊपर बताए गए तरीके से CL अपलोड करें और CQ के ड्राय रन पर क्लिक करें. इसके अलावा, Gerrit यूज़र इंटरफ़ेस (यूआई) में Testbot चुनें. आपके पास इसे आज़माने का अधिकार होना चाहिए. अगर ऐसा नहीं है, तो समीक्षक से अपने लिए बॉट शुरू करने के लिए कहें.