diff --git a/contributor_docs/hi/contributor_guidelines.md b/contributor_docs/hi/contributor_guidelines.md new file mode 100644 index 0000000000..614225ea09 --- /dev/null +++ b/contributor_docs/hi/contributor_guidelines.md @@ -0,0 +1,535 @@ +# योगदानकर्ता दिशानिर्देश + +योगदानकर्ता दिशानिर्देशों में आपका स्वागत है! यह दस्तावेज़ उन नए योगदानकर्ताओं के लिए है जो p5.js में कोड का योगदान करना चाहते हैं, योगदानकर्ता कुछ तकनीकी कदमों पर फिर से विचार करना चाह रहे हैं, या p5.js में किसी अन्य प्रकार के कोड योगदान के बारे में हैं। + +यदि आप p5.js रिपॉजिटरी के बाहर योगदान करना चाहते हैं (ट्यूटोरियल लिखना, कक्षाओं की योजना बनाना, कार्यक्रमों का आयोजन करना), तो कृपया इसके बजाय अन्य प्रासंगिक पृष्ठों पर एक नज़र डालें। प्रबंधकों या अनुरक्षकों को समस्याएँ की समीक्षा करने और अनुरोधों के संबंध में [प्रबंधक दिशानिर्देश](https://github.com/processing/p5.js/blob/main/contributor_docs/steward_guidelines.md) अधिक उपयोगी लग सकते हैं। + +यह अपेक्षाकृत लंबा और व्यापक दस्तावेज़ है लेकिन हम सभी चरणों और बिंदुओं को यथासंभव स्पष्ट रूप से इंगित करने का प्रयास करेंगे। अपने लिए प्रासंगिक अनुभाग ढूंढने के लिए विषय-सूची का उपयोग करें। यदि अनुभाग आपके नियोजित योगदान के लिए प्रासंगिक नहीं हैं, तो बेझिझक उन्हें छोड़ दें। + +**यदि आप एक नए योगदानकर्ता हैं, तो आप पहले खंड, "सभी समस्याएँ के बारे में" से शुरुआत करना चाहेंगे। यदि आप विकास प्रक्रिया का चरण-दर-चरण सेटअप चाहते हैं, तो आप "डेवलपर्स के लिए त्वरित शुरुआत करें" अनुभाग देख सकते हैं.** + +# विषयसूची + +- [योगदानकर्ता दिशानिर्देश](#योगदानकर्ता-दिशानिर्देश) +- [विषयसूची](#विषयसूची) +- [समस्याएँ के बारे में सब कुछ](#समस्याएँ-के-बारे-में-सब-कुछ) + - [समस्याएँ क्या हैं?](#समस्याएँ-क्या-हैं) + - [समस्या खाका](#समस्या-खाका) + - ["कोई बग मिला"](#कोई-बग-मिला) + - ["मौजूदा सुविधा में सुधार"](#मौजूदा-सुविधा-में-सुधार) + - ["नई सुविधा का अनुरोध"](#नई-सुविधा-का-अनुरोध) + - ["चर्चा"](#चर्चा) +- [p5.js कोडबेस पर कार्य करना](#p5js-कोडबेस-पर-कार्य-करना) + - [पूर्वावश्यकताएँ](#पूर्वावश्यकताएँ) + - [परिचय](#परिचय) + - [डेवलपर्स के लिए त्वरित शुरुआत करें](#डेवलपर्स-के-लिए-त्वरित-शुरुआत-करें) + - [गिटहब संपादन कार्यक्षमता का उपयोग करना](#गिटहब-संपादन-कार्यक्षमता-का-उपयोग-करना) + - [p5.js को फोर्क करना और अपने फोर्क से काम करना](#p5js-को-फोर्क-करना-और-अपने-फोर्क-से-काम-करना) + - [गिटहब डेस्कटॉप का उपयोग करना](#गिटहब-डेस्कटॉप-का-उपयोग-करना) + - [गिट कमांड लाइन इंटरफ़ेस का उपयोग करना](#गिट-कमांड-लाइन-इंटरफ़ेस-का-उपयोग-करना) + - [कोडबेस ब्रेकडाउन](#कोडबेस-ब्रेकडाउन) + - [सेटअप बनाएं](#सेटअप-बनाएं) + - [गिट वर्कफ़्लो](#गिट-वर्कफ़्लो) + - [सोर्स कोड](#सोर्स-कोड) + - [इकाई का परीक्षण](#इकाई-का-परीक्षण) + - [इनलाइन दस्तावेज़ीकरण](#इनलाइन-दस्तावेज़ीकरण) + - [अभिगम्यता](#अभिगम्यता) + - [कोड मानक](#कोड-मानक) + - [सॉफ़्टवेयर डिज़ाइन सिद्धांत](#सॉफ़्टवेयर-डिज़ाइन-सिद्धांत) +- [पुल रिक्वेस्ट](#पुल-रिक्वेस्ट) + - [पुल रिक्वेस्ट बनाना](#पुल-रिक्वेस्ट-बनाना) + - [पुल रिक्वेस्ट के बारे में जानकारी](#पुल-रिक्वेस्ट-के-बारे-में-जानकारी) + - [शीर्षक](#शीर्षक) + - [हल](#हल) + - [परिवर्तन](#परिवर्तन) + - [परिवर्तन के स्क्रीनशॉट](#परिवर्तन-के-स्क्रीनशॉट) + - [पीआर चेकलिस्ट](#पीआर-चेकलिस्ट) + - [विवादों को पुनः स्थापित करें और हल करें](#विवादों-को-पुनः-स्थापित-करें-और-हल-करें) + - [चर्चा करें और संशोधन करें](#चर्चा-करें-और-संशोधन-करें) + +--- + +# समस्याएँ के बारे में सब कुछ + +p5.js के गिटहब रिपॉजिटरी (संक्षेप में रेपो) पर अधिकांश गतिविधि समस्याएँ में होती है, जो आपकी योगदान यात्रा शुरू करने के लिए एक शानदार जगह है। + +## समस्याएँ क्या हैं? + +![p5.js लाइब्रेरी गिटहब रिपॉजिटरी का एक क्रॉप्ड स्क्रीनशॉट, केवल ऊपरी दाएं कोने की सामग्री दिखा रहा है। स्क्रीनशॉट के शीर्ष पर "Issue" टैब के आसपास एक लाल बॉक्स बनाया गया है।](../images/issues-tab.png) + +"समस्या" गिटहब रिपॉजिटरी पर सामान्य क्रिया है जिसका उद्देश्य किसी समस्या का वर्णन करना है।। यह समस्या एक त्रुटि रिपोर्ट, नई विशेषता जोड़ने का अनुरोध, एक चर्चा, या p5.js लाइब्रेरी विकास से संबंधित किसी भी उद्देश्य के रूप में काम कर सकती है। प्रत्येक समस्या के नीचे किसी भी गिटहब खाते वाले व्यक्ति, सहित बॉट्स, द्वारा टिप्पणियाँ जोड़ी जा सकती हैं! यह वह स्थान है जहां योगदानकर्ताओं ने परियोजना के विकास से संबंधित विषयों पर चर्चा करते हैं। + +जबकि एक समस्या कई विभिन्न कारणों के लिए खोली जा सकती है, हम आमतौर पर केवल p5.js स्रोत कोड के विकास पर चर्चा करने के लिए समस्याएँ का उपयोग करते हैं। अपने कोड का पुन: निरीक्षण, अपने परियोजना में सहयोगी निमंत्रण करने, या अन्य असंबंधित विषयों पर हम [फोरम](https://discourse.processing.com) या अन्य प्लेटफ़ॉर्मों जैसे [डिस्कोर्ड](https://discord.gg/SHQ8dH25r9) पर चर्चा करते हैं। + +हमने आपको गिटहब समस्या होनी चाहिए या कहीं और पोस्ट करनी चाहिए को निर्धारित करने में मदद करने के लिए आसान-से-उपयोग निर्देशिका बनाई हैं! + +## समस्या खाका + +p5.js के समस्या खाका उपाध्यक्षों और रखरखावकर्ताओं को समस्याओं को समझने और समीक्षा करने में सुविधा प्रदान करते हैं। ये आपको भी उचित समस्या को दर्ज करने और त्वरित उत्तर प्राप्त करने में सहायक होते हैं। + +![गिटहब पर एक मामले की जैसे दिखने वाली एक उदाहरण स्क्रीनशॉट। स्क्रीनशॉट में "Issue" का शीर्षक "सफारी में चेतावनी लॉग हो रही है जब 2डी मोड में फ़िल्टर शेडर का उपयोग किया जाता है #6597" है।](../images/github-issue.png) + +नई समस्या दर्ज करने के लिए, पहले "Issues" टैब पर जाएं p5.js रेपो पर और फिर दाएं ओर "New issue" बटन पर क्लिक करें। आपको कई विभिन्न विकल्पों के साथ प्रस्तुत किया जाएगा, जिसमें से प्रत्येक किसी संबंधित समस्या खाका का अनुसरण करता है या आपको आपके प्रश्न को दर्ज करने के लिए उचित स्थान पर पुनःनिर्देशित करता है। हम सुझाव देते हैं कि आप प्रस्तुत किए गए सभी विकल्पों में से सबसे संबंधित विकल्प का चयन करें ताकि आपकी समस्या को सही ध्यान और समय से संबोधित किया जा सके। + +![हरे "नए अंक" बटन के साथ गिटहब रिपॉजिटरी के अंक पृष्ठ का क्रॉप किया गया स्क्रीनशॉट, जिसके चारों ओर एक लाल बॉक्स हाइलाइट किया गया है।](../images/new-issue.png) + +### ["कोई बग मिला"](https://github.com/processing/p5.js/issues/new?assignees=\&labels=Bug\&projects=\&template=found-a-bug.yml) + +जब आप p5.js में संभावित अप्रत्याशित व्यवहार का सामना करते हैं या दस्तावेज़ में वर्णित अनुसार व्यवहार नहीं करते हैं, तो [इस खाका](https://github.com/processing/p5.js/issues/new?assignees=\&labels=Bug\&projects=\&template=found-a-bug.yml) उपयोग करें। + +कृपया ध्यान दें कि यदि आप अपने स्केच को पुनः निरीक्षण करने का प्रयास कर रहे हैं और आपको लगता है कि यह आपके कोड में कोई समस्या हो सकती है, तो आपको पहले [डिस्कोर्स फोरम](https://discourse.processing.org) पर पूछना चाहिए। + +इस खाका में आपको भरने के लिए कुछ फ़ील्ड हैं: + +1. *p5.js का सबसे उपयुक्त उप-क्षेत्र?* - यह हमें संबंधित [लेबल](https://github.com/processing/p5.js/blob/main/contributor_docs/issue_labels.md) के साथ समस्या को स्वचालित रूप से टैग करके आपकी समस्या को पहचानने और उसका जवाब देने में मदद करता है। +2. *p5.js संस्करण* - आप p5.js संस्करण संख्या या तो `