From f4538192d024ad02dfdcb26a744fda0b8a26b7aa Mon Sep 17 00:00:00 2001 From: Akash Jaiswal Date: Mon, 18 Mar 2024 13:36:55 +0530 Subject: [PATCH 01/11] translation: contributo guidelines --- contributor_docs/hi/contributor_guidelines.md | 550 ++++++++++++++++++ 1 file changed, 550 insertions(+) create mode 100644 contributor_docs/hi/contributor_guidelines.md diff --git a/contributor_docs/hi/contributor_guidelines.md b/contributor_docs/hi/contributor_guidelines.md new file mode 100644 index 0000000000..6e414f5223 --- /dev/null +++ b/contributor_docs/hi/contributor_guidelines.md @@ -0,0 +1,550 @@ +# योगदानकर्ता दिशानिर्देश + +योगदानकर्ता दिशानिर्देशों में आपका स्वागत है! यह दस्तावेज़ उन नए योगदानकर्ताओं के लिए है जो p5.js में कोड का योगदान करना चाहते हैं, ऐसे योगदानकर्ता जो कुछ तकनीकी चरणों पर अपनी यादें ताज़ा करना चाहते हैं, या p5.js में कोड योगदान के साथ कुछ और करना चाहते हैं। + +यदि आप p5.js रिपॉजिटरी के बाहर योगदान करना चाहते हैं (ट्यूटोरियल लिखना, कक्षाओं की योजना बनाना, कार्यक्रमों का आयोजन करना), तो कृपया इसके बजाय अन्य प्रासंगिक पृष्ठों पर एक नज़र डालें। प्रबंधकों या अनुरक्षकों को समस्याएँ की समीक्षा करने और अनुरोधों को खींचने के संबंध में [कार्यपालिका दिशानिर्देश](https://github.com/processing/p5.js/blob/main/contributor_docs/steward_guidelines.md) अधिक उपयोगी लग सकते हैं। + +यह अपेक्षाकृत लंबा और व्यापक दस्तावेज़ है लेकिन हम सभी चरणों और बिंदुओं को यथासंभव स्पष्ट रूप से इंगित करने का प्रयास करेंगे। अपने लिए प्रासंगिक अनुभाग ढूंढने के लिए विषय-सूची का उपयोग करें। यदि अनुभाग आपके नियोजित योगदान के लिए प्रासंगिक नहीं हैं, तो बेझिझक उन्हें छोड़ दें। + +**यदि आप एक नए योगदानकर्ता हैं, तो आप पहले खंड, "सभी समस्याएँ के बारे में" से शुरुआत करना चाहेंगे। यदि आप विकास प्रक्रिया का चरण-दर-चरण सेटअप चाहते हैं, तो आप "डेवलपर्स के लिए त्वरित शुरुआत करें" अनुभाग देख सकते हैं.** + + +# Table of Contents + +- [All about issues](#all-about-issues) + - [What are issues?](#what-are-issues) + - [Issue templates](#issue-templates) + - [Found a bug](#found-a-bug) + - [Existing Feature Enhancement](#existing-feature-enhancement) + - [New Feature Request](#new-feature-request) + - [Discussion](#discussion) +- [Working on p5.js codebase](#working-on-the-p5js-codebase) + - [Quick Get Started For Developers](#quick-get-started-for-developers) + - [Using the Github edit functionality](#using-the-github-edit-functionality) + - [Forking p5.js and working from your fork](#forking-p5js-and-working-from-your-fork) + - [Using Github Desktop](#using-github-desktop) + - [Using the git command line interface](#using-the-git-command-line-interface) + - [Codebase breakdown](#codebase-breakdown) + - [Build setup](#build-setup) + - [Git workflow](#git-workflow) + - [Source code](#source-code) + - [Unit tests](#unit-tests) + - [Inline documentation](#inline-documentation) + - [Internationalization](https://github.com/processing/p5.js/blob/main/contributor_docs/contributor_guidelines.md#internationalization) + - [Accessibility](#accessibility) + - [Code standard](#code-standard) + - [Software Design principles](#software-design-principles) +- [Pull requests](#pull-requests) + - [Creating a pull request](#creating-a-pull-request) + - [Pull request information](#pull-request-information) + - [Title](#title) + - [Resolves](#resolves) + - [Changes](#changes) + - [Screenshots of the change](#screenshots-of-the-change) + - [PR Checklist](#pr-checklist) + - [Rebase and resolve conflicts](#rebase-and-resolve-conflicts) + - [Discuss and amend](#discuss-and-amend) + +--- + + +# समस्याएँ के बारे में सब कुछ + +p5.js के गिटहब रिपॉजिटरी (संक्षेप में रेपो) पर अधिकांश गतिविधि समस्याएँ में होती है, जो आपकी योगदान यात्रा शुरू करने के लिए एक शानदार जगह है। + + +## What are issues? + +![A cropped screenshot of the p5.js library GitHub repository, only showing contents of the top right corner. A red box is drawn on top of the screenshot surrounding the Issues tab.](images/issues-tab.png) + +"समस्या" GitHub पर एक पोस्ट के लिए एक सामान्य नाम है जो किसी समस्या को वर्णित करने का उद्देश्य रखता है। यह समस्या एक बग रिपोर्ट, नई फीचर जोड़ने का अनुरोध, एक चर्चा, या p5.js पुस्तकालय विकास से संबंधित किसी भी पोस्ट के रूप में काम कर सकती है। प्रत्येक समस्या के नीचे किसी भी GitHub खाते वाले व्यक्ति, सहित बॉट्स, द्वारा टिप्पणियाँ जोड़ी जा सकती हैं! यह वह स्थान है जहां योगदानकर्ताओं ने परियोजना के विकास से संबंधित विषयों पर चर्चा करते हैं। + +जबकि एक समस्या कई विभिन्न कारणों के लिए खोली जा सकती है, हम आमतौर पर केवल p5.js स्रोत कोड के विकास पर चर्चा करने के लिए समस्याएँ का उपयोग करते हैं। अपने कोड की डीबगिंग, अपने परियोजना में सहयोगी निमंत्रण करने, या अन्य असंबंधित विषयों जैसे विषयों पर हम केवल [फोरम](https://discourse.processing.com) या अन्य प्लेटफ़ॉर्मों जैसे [डिस्कोर्ड](https://discord.gg/SHQ8dH25r9) पर चर्चा करते हैं। + +हमने आपको GitHub समस्या होनी चाहिए या कहीं और पोस्ट करनी चाहिए को निर्धारित करने में मदद करने के लिए आसान-से-उपयोग निर्देशिका बनाई हैं! + + +## Issue templates + +p5.js's issue templates make it easier for stewards and maintainers to understand and review issues. They also make it easier for you to file the relevant issue and receive a reply faster.  + +![Screenshot of an example of what an issue looks like on GitHub. The title of the issue in the screenshot is "Warning being logged in Safari when using a filter shader in 2D mode #6597"](images/github-issue.png) + +To file a new issue, simply go to the "Issues" tab on the p5.js repo and click on the "New issue" button on the right side. You will be presented with several different options, each of which either corresponds to a relevant issue template or redirects you to the relevant place to file your question. We recommend choosing the most relevant option out of those presented to ensure your issue receives the right attention promptly. + +![Cropped screenshot of the GitHub repository's issue page with the green "New issue" button highlighted with a red box surrounding it.](images/new-issue.png) + + +### ["Found a bug"](https://github.com/processing/p5.js/issues/new?assignees=\&labels=Bug\&projects=\&template=found-a-bug.yml) + +When you encounter possible incorrect behavior in p5.js or something not behaving as described in the documentation, use [this template](https://github.com/processing/p5.js/issues/new?assignees=\&labels=Bug\&projects=\&template=found-a-bug.yml). Please note that if you are trying to debug your sketch and you think it may be a problem with your code, you should first ask on the [Discourse forum](https://discourse.processing.org) instead. + +There are a few fields for you to fill in for this template: + +1. *Most appropriate sub-area of p5.js?* - This helps us identify and respond to your issue by automatically tagging the issue with the relevant [labels](https://github.com/processing/p5.js/blob/main/contributor_docs/issue_labels.md). +2. *p5.js version* - You can find the p5.js version number in either the `