From 7732be1e24ce40c8857b06d7498c93f19996b9c7 Mon Sep 17 00:00:00 2001 From: ChandraDevs1 Date: Thu, 3 Oct 2024 23:12:27 +0530 Subject: [PATCH 1/2] Added Contributing-hi.md file --- docs/CONTRIBUTING-hi.md | 271 ++++++++++++++++++++++++++++++++++++++++ docs/README.md | 1 + 2 files changed, 272 insertions(+) create mode 100644 docs/CONTRIBUTING-hi.md diff --git a/docs/CONTRIBUTING-hi.md b/docs/CONTRIBUTING-hi.md new file mode 100644 index 0000000000000..777393e36036b --- /dev/null +++ b/docs/CONTRIBUTING-hi.md @@ -0,0 +1,271 @@ +*[अन्य भाषाओं में इसे पढ़ें](README.md#translations)* + + +## योगदानकर्ता लाइसेंस समझौता + +योगदान करने पर, आप इस रिपॉजिटरी के [LICENSE](../LICENSE) से सहमत होते हैं। + + +## योगदानकर्ता आचार संहिता + +योगदान करने पर, आप इस रिपॉजिटरी की [आचार संहिता](CODE_OF_CONDUCT.md) का पालन करने के लिए सहमत होते हैं। ([अनुवाद](README.md#translations)) + + +## संक्षेप में + +1. "किताब को आसानी से डाउनलोड करने का एक लिंक" हमेशा *नि:शुल्क* किताब का लिंक नहीं होता है। कृपया केवल नि:शुल्क सामग्री ही योगदान करें। सुनिश्चित करें कि यह नि:शुल्क हो। हम ऐसे पेजों के लिंक स्वीकार नहीं करते हैं जो किताबें प्राप्त करने के लिए कार्यशील ईमेल पतों की *आवश्यकता* होती है, लेकिन हम उन लिस्टिंग का स्वागत करते हैं जिनमें इसे अनुरोध किया जाता है। + +2. आपको Git जानने की आवश्यकता नहीं है: यदि आपने कुछ ऐसा पाया है जो *पहले से इस रिपॉजिटरी में नहीं है*, तो कृपया अपने लिंक प्रस्तावों के साथ एक [Issue](https://github.com/EbookFoundation/free-programming-books/issues) खोलें। + - यदि आप Git जानते हैं, तो कृपया रिपॉजिटरी को Fork करें और Pull Requests (PR) भेजें। + +3. हमारे पास 6 प्रकार की लिस्ट हैं। सही का चुनाव करें: + + - *किताबें* : PDF, HTML, ePub, gitbook.io आधारित साइट, Git रिपॉजिटरी आदि। + - *पाठ्यक्रम* : एक पाठ्यक्रम वह शिक्षण सामग्री है जो किताब नहीं है। [यह एक पाठ्यक्रम है](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/)। + - *इंटरएक्टिव ट्यूटोरियल्स* : एक इंटरएक्टिव वेबसाइट जो उपयोगकर्ता को कोड या कमांड टाइप करने देती है और परिणाम का मूल्यांकन करती है (यहां "मूल्यांकन" का मतलब "ग्रेड देना" नहीं है)। जैसे: [Try Haskell](http://tryhaskell.org), [Try Git](https://learngitbranching.js.org)। + - *प्लेग्राउंड्स* : ऑनलाइन और इंटरएक्टिव वेबसाइटें, गेम्स या डेस्कटॉप सॉफ़्टवेयर जो प्रोग्रामिंग सिखाने के लिए होते हैं। कोड स्निपेट्स लिखें, कम्पाइल करें (या चलाएं), और साझा करें। प्लेग्राउंड्स अक्सर आपको कोड के साथ खेलने और इसे फोर्क करने की अनुमति देते हैं। + - *पॉडकास्ट्स और स्क्रीनकास्ट्स* : पॉडकास्ट्स और स्क्रीनकास्ट्स। + - *समस्याएँ और प्रतिस्पर्धी प्रोग्रामिंग* : एक वेबसाइट या सॉफ़्टवेयर जो आपको सरल या जटिल समस्याओं को हल करके अपनी प्रोग्रामिंग कौशल का मूल्यांकन करने देती है, कोड समीक्षा के साथ या बिना, अन्य उपयोगकर्ताओं के साथ तुलना करके या बिना। + +4. सुनिश्चित करें कि आप [नीचे दिए गए दिशानिर्देशों](#guidelines) का पालन करते हैं और फ़ाइलों के [Markdown प्रारूप](#formatting) का सम्मान करते हैं। + +5. GitHub Actions परीक्षण चलाएगा ताकि **आपकी लिस्ट अल्फाबेटिकल ऑर्डर में हो** और **फ़ॉर्मेटिंग नियमों का पालन हो**। **सुनिश्चित करें** कि आपके परिवर्तनों ने परीक्षण पास किए हैं। + + +### दिशानिर्देश + +- सुनिश्चित करें कि कोई किताब नि:शुल्क है। यदि आवश्यक हो, तो दोबारा जांचें। यदि आप PR में यह टिप्पणी करते हैं कि आपको लगता है कि किताब नि:शुल्क क्यों है, तो यह एडमिन्स की मदद करेगा। +- हम Google Drive, Dropbox, Mega, Scribd, Issuu और अन्य समान फ़ाइल अपलोड प्लेटफ़ॉर्म पर होस्ट की गई फ़ाइलें स्वीकार नहीं करते। +- अपने लिंक को अल्फाबेटिकल ऑर्डर में डालें, जैसा कि [नीचे](#alphabetical-order) वर्णित है। +- सबसे प्रामाणिक स्रोत वाले लिंक का उपयोग करें (जिसका अर्थ है लेखक की वेबसाइट संपादक की वेबसाइट से बेहतर होती है, जो तीसरे पक्ष की वेबसाइट से बेहतर होती है)। + - कोई फ़ाइल होस्टिंग सेवाएँ नहीं (इसमें Dropbox और Google Drive लिंक भी शामिल हैं)। +- हमेशा `https` लिंक को `http` लिंक पर प्राथमिकता दें -- बशर्ते वे एक ही डोमेन पर हों और वही सामग्री प्रस्तुत करते हों। +- रूट डोमेन पर, अंतिम स्लैश को हटा दें: `http://example.com` को `http://example.com/` की बजाय। +- हमेशा सबसे छोटा लिंक चुनें: `http://example.com/dir/` `http://example.com/dir/index.html` से बेहतर है। + - कोई URL शॉर्टनर लिंक नहीं। +- सामान्यतः "current" लिंक को "version" वाले लिंक पर प्राथमिकता दें: `http://example.com/dir/book/current/` `http://example.com/dir/book/v1.0.0/index.html` से बेहतर है। +- यदि किसी लिंक का प्रमाणपत्र समाप्त हो गया है/स्वयं-साइन प्रमाणपत्र/SSL समस्या है: + 1. *इसे* इसके `http` समकक्ष से बदलें, यदि संभव हो (क्योंकि मोबाइल उपकरणों पर अपवादों को स्वीकार करना जटिल हो सकता है)। + 2. *इसे छोड़ दें* अगर कोई `http` संस्करण उपलब्ध नहीं है, लेकिन लिंक अभी भी ब्राउज़र में अपवाद जोड़कर या चेतावनी को नजरअंदाज करके `https` के माध्यम से एक्सेस किया जा सकता है। + 3. *इसे हटा दें* अन्यथा। +- यदि कोई लिंक एक से अधिक प्रारूपों में उपलब्ध है, तो प्रत्येक प्रारूप के साथ एक अलग लिंक जोड़ें। +- यदि किसी संसाधन के इंटरनेट पर विभिन्न स्थानों पर संस्करण हैं: + - सबसे प्रामाणिक स्रोत वाले लिंक का उपयोग करें। + - यदि वे अलग-अलग संस्करणों के लिंक देते हैं, और आप इन संस्करणों को रखने लायक समझते हैं, तो प्रत्येक संस्करण के साथ एक अलग लिंक जोड़ें। +- परमाणु कमिट्स (प्रत्येक जोड़/हटाव/संशोधन के लिए एक कमिट) को बड़े कमिट्स पर प्राथमिकता दें। PR सबमिट करने से पहले अपने कमिट्स को मर्ज करने की आवश्यकता नहीं है। +- यदि किताब पुरानी है, तो शीर्षक के साथ प्रकाशन तिथि शामिल करें। +- जहां उपयुक्त हो, लेखक का नाम या नाम शामिल करें। आप लेखक की सूची को "`et al.`" के साथ संक्षिप्त कर सकते हैं। +- यदि किताब अधूरी है, और अभी भी काम किया जा रहा है, तो "`in process`" नोटेशन जोड़ें, जैसा कि [नीचे](#in_process) वर्णित है। +- यदि किसी संसाधन को [*Internet Archive's Wayback Machine*](https://web.archive.org) (या समान) के माध्यम से पुनर्स्थापित किया जाता है, तो "`archived`" नोटेशन जोड़ें, जैसा कि [नीचे](#archived) वर्णित है। उपयोग के लिए सर्वश्रेष्ठ संस्करण हालिया और पूर्ण होते हैं। +- यदि डाउनलोड सक्षम होने से पहले एक ईमेल पता या खाता सेटअप मांगा जाता है, तो उपयुक्त भाषा में टिप्पणियाँ कोष्ठक में जोड़ें, जैसे: `(ईमेल पता *अनुरोधित*, आवश्यक नहीं)`. + + +### प्रारूप + +- सभी लिस्टें `.md` फ़ाइलें होती हैं। [Markdown](https://guides.github.com/features/mastering-markdown/) सिंटैक्स सीखने की कोशिश करें। +- सभी लिस्टें एक इंडेक्स के साथ शुरू होती हैं। विचार यह है कि सभी अनुभागों और उप-अनुभागों को वहां सूचीबद्ध और लिंक करें। इसे वर्णानुक्रम में रखें। +- अनुभाग स्तर 3 हेडिंग्स (`###`), और उप-अनुभाग स्तर 4 हेडिंग्स (`####`) का उपयोग करते हैं। + +विचार यह है कि: + +- अंतिम लिंक और नए अनुभाग के बीच `2` खाली पंक्तियां होनी चाहिए। +- शीर्षक और उसके अनुभाग के पहले लिंक के बीच `1` खाली पंक्ति होनी चाहिए। +- दो लिंक के बीच कोई खाली पंक्ति नहीं होनी चाहिए। +- प्रत्येक `.md` फ़ाइल के अंत में `1` खाली पंक्ति होनी चाहिए। + +उदाहरण: + +```text +[...] +* [An Awesome Book](http://example.com/example.html) + (खाली पंक्ति) + (खाली पंक्ति) +### Example + (खाली पंक्ति) +* [Another Awesome Book](http://example.com/book.html) +* [Some Other Book](http://example.com/other.html) +``` + +- `]` और `(` के बीच जगह न रखें: + + ```text + BAD : * [Another Awesome Book] (http://example.com/book.html) + GOOD: * [Another Awesome Book](http://example.com/book.html) + ``` + +- यदि आप लेखक को शामिल करते हैं, तो ` - ` का उपयोग करें: + + ```text + BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe + GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe + ``` + +- लिंक और उसके प्रारूप के बीच एक जगह रखें: + + ```text + BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF) + GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF) + ``` + +- लेखक प्रारूप से पहले आता है: + + ```text + BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe + GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF) + ``` + + - एक से अधिक प्रारूप (हम प्रत्येक संसाधन के लिए एक लिंक को प्राथमिकता देते हैं। जब एकल लिंक के साथ विभिन्न प्रारूपों तक आसान पहुंच नहीं होती है, तो कई लिंक मायने रखते हैं। लेकिन हम हर लिंक को जोड़ने से बचते हैं क्योंकि इससे रखरखाव का भार बढ़ता है।): + + ```text + BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML) + BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site) + GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) + ``` + +- पुरानी किताबों के लिए शीर्षक में प्रकाशन वर्ष शामिल करें: + + ```text + BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970 + GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe + ``` + +- In-process books: + + ```text + GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) *(:construction: in process)* + ``` + +- Archived link: + + ```text + GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* + ``` + +### वर्णानुक्रम + +- जब कई शीर्षक एक ही अक्षर से शुरू होते हैं, तो उन्हें दूसरे अक्षर के आधार पर क्रमबद्ध करें, और इसी तरह। उदाहरण के लिए: `aa` से `ab` पहले आता है। +- `one two` से `onetwo` पहले आता है। + +यदि आप कोई गलत स्थान पर लिंक देखते हैं, तो लिंटर एरर संदेश की जांच करें कि कौन सी पंक्तियों को अदला-बदली की जानी चाहिए। + + +### नोट्स + +हालांकि मूल बातें अपेक्षाकृत सरल हैं, लेकिन हमारी सूचीबद्ध संसाधनों में बड़ी विविधता है। यहां कुछ नोट्स दिए गए हैं कि हम इस विविधता से कैसे निपटते हैं। + + +#### मेटाडेटा + +हमारी सूचियां न्यूनतम मेटाडेटा प्रदान करती हैं: शीर्षक, URL, रचनाकार, प्लेटफ़ॉर्म और एक्सेस नोट्स। + + +##### शीर्षक + +- कोई बनाए हुए शीर्षक नहीं। हम शीर्षक संसाधनों से लेते हैं; योगदानकर्ताओं को सलाह दी जाती है कि वे शीर्षक न बनाएं या संपादकीय रूप से उनका उपयोग न करें, जब तक कि इसे टाला न जा सके। पुराने कार्यों के लिए एक अपवाद है; यदि वे मुख्य रूप से ऐतिहासिक रुचि के हैं, तो शीर्षक में वर्ष जोड़ने से उपयोगकर्ताओं को यह जानने में मदद मिलती है कि वे किस वर्ष के हैं। +- कोई ALLCAPS शीर्षक नहीं। आमतौर पर टाइटल केस उपयुक्त होता है, लेकिन संदेह होने पर स्रोत से लिए गए कैपिटलाइज़ेशन का उपयोग करें। +- कोई इमोजी नहीं। + + +##### URLs + +- हम छोटे URLs की अनुमति नहीं देते। +- URL से ट्रैकिंग कोड हटा दिया जाना चाहिए। +- अंतर्राष्ट्रीय URLs को एस्केप किया जाना चाहिए। ब्राउज़र बार आमतौर पर इन्हें यूनिकोड में प्रस्तुत करते हैं, लेकिन कृपया कॉपी और पेस्ट का उपयोग करें। +- सुरक्षित (`https`) URLs को हमेशा असुरक्षित (`http`) URLs पर प्राथमिकता दी जाती है, जहां HTTPS लागू किया गया हो। +- हमें ऐसे URLs पसंद नहीं हैं जो सूचीबद्ध संसाधन की मेजबानी नहीं करते, बल्कि कहीं और ले जाते हैं। + + +##### रचनाकार + +- हम जहां उपयुक्त हो, नि:शुल्क संसाधनों के रचनाकारों को श्रेय देना चाहते हैं, जिनमें अनुवादक भी शामिल हैं! +- अनुवादित कार्यों के लिए मूल लेखक को श्रेय दिया जाना चाहिए। हम लेखकों के अलावा अन्य रचनाकारों को श्रेय देने के लिए [MARC relators](https://loc.gov/marc/relators/relaterm.html) का उपयोग करने की अनुशंसा करते हैं, जैसा कि इस उदाहरण में है: + + ```markdown + * [A Translated Book](http://example.com/book.html) - John Doe, `trl.:` Mike The Translator + ``` + + यहां `trl.:` का एनोटेशन "अनुवादक" के लिए MARC रिलेटर कोड का उपयोग करता है। +- प्रत्येक आइटम को अलग करने के लिए कॉमा `,` का उपयोग करें। +- आप लेखक सूचियों को "`et al.`" के साथ संक्षिप्त कर सकते हैं। +- हम रचनाकारों के लिए लिंक की अनुमति नहीं देते। +- संकलन या मिश्रित कार्यों के लिए, "रचनाकार" का वर्णन आवश्यक हो सकता है। उदाहरण के लिए, "GoalKicker" या "RIP Tutorial" किताबें इस प्रकार श्रेय दी जाती हैं "`Compiled from StackOverflow documentation`"। +- हम रचनाकारों के नामों में "Prof." या "Dr." जैसे सम्मानजनक शब्दों को शामिल नहीं करते। + + +##### समय-सीमित पाठ्यक्रम और परीक्षण + +- हम उन संसाधनों को सूचीबद्ध नहीं करते जिन्हें हमें छह महीने में निकालने की आवश्यकता होगी। +- यदि किसी पाठ्यक्रम में सीमित नामांकन अवधि या समय सीमा है, तो हम इसे सूचीबद्ध नहीं करेंगे। +- हम उन संसाधनों को सूचीबद्ध नहीं कर सकते जो सीमित समय के लिए नि:शुल्क हैं। + + +##### प्लेटफ़ॉर्म और एक्सेस नोट्स + +- पाठ्यक्रम। विशेष रूप से हमारे पाठ्यक्रम सूचियों के लिए, प्लेटफ़ॉर्म संसाधन विवरण का एक महत्वपूर्ण हिस्सा है। यह इसलिए है क्योंकि पाठ्यक्रम प्लेटफ़ॉर्म में अलग-अलग एक्सेस मॉडल होते हैं। जहां हम आमतौर पर ऐसी किताबों को सूचीबद्ध नहीं करेंगे जिनके लिए पंजीकरण की आवश्यकता होती है, वहीं कई पाठ्यक्रम प्लेटफ़ॉर्म के लिए खाते की आवश्यकता होती है। उदाहरण पाठ्यक्रम प्लेटफ़ॉर्म में Coursera, EdX, Udacity, और Udemy शामिल हैं। जब कोई पाठ्यक्रम प्लेटफ़ॉर्म पर निर्भर करता है, तो प्लेटफ़ॉर्म का नाम कोष्ठक में सूचीबद्ध किया जाना चाहिए। +- YouTube। हमारे पास कई पाठ्यक्रम हैं जो YouTube प्लेलिस्ट पर आधारित हैं। हम YouTube को प्लेटफ़ॉर्म के रूप में सूचीबद्ध नहीं करते, बल्कि YouTube के निर्माता को सूचीबद्ध करने का प्रयास करते हैं, जो अक्सर एक उप-प्लेटफ़ॉर्म होता है। +- YouTube वीडियो। हम आम तौर पर YouTube वीडियो के लिंक नहीं देते जब तक कि वे एक घंटे से अधिक लंबे न हों और एक पाठ्यक्रम या ट्यूटोरियल की तरह संरचित न हों। यदि ऐसा है, तो PR विवरण में इसका उल्लेख अवश्य करें। +- छोटे (जैसे youtu.be/xxxx) लिंक नहीं! +- Leanpub। Leanpub विभिन्न एक्सेस मॉडल वाली किताबों की मेजबानी करता है। कभी-कभी किसी किताब को पंजीकरण के बिना पढ़ा जा सकता है; कभी-कभी नि:शुल्क एक्सेस के लिए Leanpub खाते की आवश्यकता होती है। किताबों की गुणवत्ता और Leanpub एक्सेस मॉडल के मिश्रण को देखते हुए, हम Leanpub खाता या मान्य ईमेल अनुरोध वाले नोट के साथ इस लिस्टिंग की अनुमति देते हैं। + + +#### शैलियाँ + +किस सूची में कोई संसाधन आता है, यह तय करने का पहला नियम यह देखना है कि संसाधन खुद को कैसे वर्णित करता है। यदि वह खुद को किताब कहता है, तो संभवतः वह किताब है। + + +##### शैलियाँ जिन्हें हम सूचीबद्ध नहीं करते + +इंटरनेट विशाल है, इसलिए हम अपनी सूचियों में निम्नलिखित शामिल नहीं करते हैं: + +- ब्लॉग +- ब्लॉग पोस्ट +- लेख +- वेबसाइटें (उनको छोड़कर जो ढेर सारे संसाधनों की मेजबानी करती हैं जिन्हें हम सूचीबद्ध करते हैं)। +- वीडियो जो पाठ्यक्रम या स्क्रीनकास्ट नहीं हैं। +- किताब के अध्याय +- किताबों से टीज़र नमूने +- IRC या Telegram चैनल +- Slacks या मेलिंग सूचियां + +हमारी प्रतिस्पर्धी प्रोग्रामिंग सूची इन बहिष्करणों के बारे में उतनी सख्त नहीं है। रिपॉजिटरी का दायरा समुदाय द्वारा निर्धारित किया जाता है; यदि आप दायरे में बदलाव या जोड़ने का सुझाव देना चाहते हैं, तो कृपया सुझाव देने के लिए एक issue का उपयोग करें। + + +##### किताबें बनाम अन्य चीजें + +हम किताबों के बारे में उतने सख्त नहीं हैं। यहां कुछ विशेषताएं दी गई हैं जो यह बताती हैं कि कोई संसाधन किताब है: + +- इसमें ISBN (अंतर्राष्ट्रीय मानक पुस्तक संख्या) है। +- इसमें एक Table of Contents है। +- एक डाउनलोड करने योग्य संस्करण की पेशकश की जाती है, विशेष रूप से ePub फ़ाइलें। +- इसमें संस्करण होते हैं। +- यह इंटरएक्टिव सामग्री या वीडियो पर निर्भर नहीं करता। +- यह किसी विषय को व्यापक रूप से कवर करने का प्रयास करता है। +- यह आत्म-निर्भर होता है। + +हम कई किताबों को सूचीबद्ध करते हैं जिनमें ये विशेषताएं नहीं होती हैं; यह संदर्भ पर निर्भर करता है। + + +##### किताबें बनाम पाठ्यक्रम + +कभी-कभी इन्हें अलग करना कठिन हो सकता है! + +पाठ्यक्रमों में अक्सर पाठ्यपुस्तकें होती हैं, जिन्हें हम अपनी किताबों की सूची में सूचीबद्ध करेंगे। पाठ्यक्रमों में व्याख्यान, अभ्यास, परीक्षाएं, नोट्स या अन्य शिक्षण साधन होते हैं। अकेला व्याख्यान या वीडियो अपने आप में पाठ्यक्रम नहीं है। एक पावरपॉइंट पाठ्यक्रम नहीं है। + + +##### इंटरएक्टिव ट्यूटोरियल्स बनाम अन्य चीजें + +यदि आप इसे प्रिंट कर सकते हैं और इसकी मूल भावना को बनाए रख सकते हैं, तो यह एक इंटरएक्टिव ट्यूटोरियल नहीं है। + + +### स्वचालन + +- फॉर्मेटिंग नियमों को लागू करने के लिए [GitHub Actions](https://github.com/features/actions) का उपयोग किया जाता है, जो [fpb-lint](https://github.com/vhf/free-programming-books-lint) का उपयोग करता है (देखें [`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml))। +- URL सत्यापन [awesome_bot](https://github.com/dkhamsing/awesome_bot) का उपयोग करता है। +- URL सत्यापन को ट्रिगर करने के लिए, एक कमिट पुश करें जिसमें `check_urls=file_to_check` संदेश शामिल हो: + + ```properties + check_urls=free-programming-books.md free-programming-books-en.md + ``` + +- आप जांच करने के लिए एक से अधिक फ़ाइलों को निर्दिष्ट कर सकते हैं, प्रत्येक प्रविष्टि को अलग करने के लिए एकल स्पेस का उपयोग करें। +- यदि आप एक से अधिक फ़ाइलों को निर्दिष्ट करते हैं, तो बिल्ड के परिणाम अंतिम जाँची गई फ़ाइल पर आधारित होंगे। आपको यह ध्यान रखना चाहिए कि इसके कारण आपको हरे रंग का पासिंग बिल्ड प्राप्त हो सकता है, इसलिए Pull Request के अंत में बिल्ड लॉग की जाँच करने के लिए "Show all checks" -> "Details" पर क्लिक करना सुनिश्चित करें। \ No newline at end of file diff --git a/docs/README.md b/docs/README.md index 7764a86f2fe1e..5a6a05df5e9b8 100644 --- a/docs/README.md +++ b/docs/README.md @@ -52,6 +52,7 @@ Volunteers have translated many of our Contributing, How-to, and Code of Conduct - Hebrew / עברית - [How-to איך לעשות את זה](HOWTO-he.md) - Hindi / हिन्दी + - [योगदान](CONTRIBUTING-hi.md) - [आचार संहिता](CODE_OF_CONDUCT-hi.md) - [How-to](HOWTO-hi.md) - Hungarian / magyar / magyar nyelv From 1c6c409dc20192389610d5ab23ffc7bf3445bb7d Mon Sep 17 00:00:00 2001 From: ChandraDevs1 Date: Fri, 4 Oct 2024 00:48:55 +0530 Subject: [PATCH 2/2] Added contributing-t.md file --- docs/CONTRIBUTING-ta.md | 271 ++++++++++++++++++++++++++++++++++++++++ docs/README.md | 1 + 2 files changed, 272 insertions(+) create mode 100644 docs/CONTRIBUTING-ta.md diff --git a/docs/CONTRIBUTING-ta.md b/docs/CONTRIBUTING-ta.md new file mode 100644 index 0000000000000..14d467fbef4d0 --- /dev/null +++ b/docs/CONTRIBUTING-ta.md @@ -0,0 +1,271 @@ +*[மற்ற மொழிகளில் இதைப் படிக்கவும்](README.md#translations)* + + +## Contributor License Agreement + +கொடுப்பதன் மூலம், நீங்கள் இந்த repository-யின் [LICENSE](../LICENSE) உடன் ஒப்பந்தம் செய்ய சம்மதிக்கிறீர்கள். + + +## Contributor Code of Conduct + +கொடுப்பதன் மூலம், நீங்கள் இந்த repository-யின் [Code of Conduct](CODE_OF_CONDUCT.md) யை மதிக்கவும், பின்பற்றவும் ஒப்புக்கொள்கிறீர்கள். ([translations](README.md#translations)) + +## சுருக்கமாக + +1. "ஒரு புத்தகத்தை எளிதாகப் பதிவிறக்கம் செய்ய ஒரு link" என்பது எப்போதும் *இலவச* புத்தகத்திற்கு உள்ள link ஆகவே இருக்காது. தயவுசெய்து இலவச உள்ளடக்கத்தை மட்டும் கொடுங்கள். அது இலவசம் என்பதில் உறுதியாக இருங்கள். புத்தகங்களைப் பெற *வேலை செய்யும் email addresses தேவைப்படுகின்ற* pagesக்கு நாங்கள் linksஐ ஏற்கமாட்டோம், ஆனால் அவற்றைப் பரிந்துரைக்கும் listingsஐ வரவேற்கிறோம். + +2. உங்களுக்கு Git தெரியவேண்டிய அவசியம் இல்லை: நீங்கள் *இந்த repositoryயில் ஏற்கனவே இல்லாத* ஒன்றைக் கண்டுபிடித்தால், உங்கள் linkகள் பரிந்துரைகளுடன் [Issue](https://github.com/EbookFoundation/free-programming-books/issues)ஐ திறக்கவும். + - உங்களுக்கு Git தெரிந்தால், repositoryயை Fork செய்து Pull Requests (PR) அனுப்பவும். + +3. எங்களிடம் 6 வகையான பட்டியல்கள் உள்ளன. சரியானதை தேர்வுசெய்யவும்: + + - *Books* : PDF, HTML, ePub, gitbook.io அடிப்படையிலான தளம், Git repo, மற்றும் இதரவை. + - *Courses* : Course என்பது புத்தகமாக இல்லாத கற்றல் உபகரணம். [இது ஒரு course](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). + - *Interactive Tutorials* : பயனர் code அல்லது commands ஐ தட்டச்சு செய்ய அனுமதித்து, அதன் முடிவுகளை மதிப்பீடு செய்யும் (இங்கே "evaluate" என்பது "grade" செய்யவேண்டும் என்று அர்த்தமில்லை) ஒரு interactive website. உதாரணம்: [Try Haskell](http://tryhaskell.org), [Try Git](https://learngitbranching.js.org). + - *Playgrounds* : ஆன்லைனில் மற்றும் interactiveவாக இயங்கும் websites, games அல்லது desktop softwareகள், programming கற்றுக்கொடுக்க உதவும். Code snippets எழுதி, compile (அல்லது இயக்கி), மற்றும் share செய்யுங்கள். Playgroundsகள் codeஐ விளையாடவோ அல்லது fork செய்யவோ அனுமதிக்கின்றன. + - *Podcasts and Screencasts* : Podcasts மற்றும் screencasts. + - *Problem Sets & Competitive Programming* : எளிய அல்லது சிக்கலான பிரச்சனைகளை தீர்த்து, உங்களுடைய programming திறன்களை மதிப்பீடு செய்ய website அல்லது software, code review உடன் அல்லது இல்லாமல், மற்ற பயனர்களுடன் ஒப்பிட்டு அல்லது இல்லாமல். + +4. [கீழுள்ள வழிமுறைகளை](#guidelines) பின்பற்றவும் மற்றும் கோப்புகளின் [Markdown வடிவமைப்பைப்](#formatting) மதிக்கவும் உறுதிசெய்யவும். + +5. GitHub Actions உங்களுடைய **பட்டியல்கள் வரிசைப்படுத்தப்பட்டுள்ளன** என்பதையும், **formatting விதிகள் பின்பற்றப்பட்டுள்ளன** என்பதையும் சரிபார்க்கும். **உங்கள் மாற்றங்கள் சோதனைகளை கடக்கின்றனவா என்பதை உறுதிப்படுத்துங்கள்.** + +### Guidelines + +- ஒரு புத்தகம் இலவசமானது என்பதை உறுதிப்படுத்துங்கள். தேவைப்பட்டால் இருமுறை சரிபார்க்கவும். PR இல் நீங்கள் புத்தகம் இலவசம் என்று நினைப்பதற்கான காரணத்தைச் சொன்னால், அது admins க்கு உதவும். +- Google Drive, Dropbox, Mega, Scribd, Issuu மற்றும் இதர சமானமான file upload platforms இல் hosted files ஐ ஏற்கமாட்டோம். +- உங்கள் links ஐ alphabetical order இல் நுழைக்கவும், [கீழே விளக்கப்பட்டுள்ள](#alphabetical-order)படி. +- மிக authority உடைய source (எழுத்தாளரின் website editorன் websiteயைவிட மேம்பட்டது, editorன் website மூன்றாம் பக்கம் விட மேம்பட்டது) உடைய linkஐ பயன்படுத்தவும். + - file hosting services (இதில் Dropbox மற்றும் Google Drive links அடங்கும்) இல்லை. +- எப்போதும் `https` link ஐ `http` linkக்கு முன்னுரிமையாய் கொடுக்கவும் -- அவை ஒரே domain இல் இருக்கும்போது மற்றும் ஒரே உள்ளடக்கத்தை வழங்கும்போது. +- root domainsல் trailing slash ஐ நீக்கவும்: `http://example.com` badhil `http://example.com/` +- எப்போதும் குறைவான link ஐ பயன்படுத்தவும்: `http://example.com/dir/` என்பதே `http://example.com/dir/index.html`ஐ விட மேம்பட்டது. + - URL shortener links இல்லை. +- பொதுவாக "current" linkக்கு "version" linkக்கு முன்னுரிமை கொடுக்கவும்: `http://example.com/dir/book/current/` என்பதே `http://example.com/dir/book/v1.0.0/index.html`விட மேம்பட்டது. +- ஒரு linkக்கு சான்றிதழ் காலாவதியானது/தானாகவே ஒப்பமிட்ட சான்றிதழ்/SSL சிக்கல் ஏதேனும் இருப்பின்: + 1. *அதை மாற்றவும்* அதன் `http` படிக்கூடியவரை (mobile devices இல் விலக்கு சேமிப்பு சிக்கலாக இருக்கக்கூடும் என்பதால்). + 2. *அதை விடுங்கள்* `http` பதிப்பு கிடைக்கவில்லை ஆனால் browserக்கு விலக்கு சேர்த்தவுடன் அல்லது எச்சரிக்கையை புறக்கணித்தவுடன் link `https` மூலம் அணுகக்கூடியதாக இருந்தால். + 3. *அதை நீக்குங்கள்* இல்லையென்றால். +- ஒரு link பல வடிவங்களில் இருந்தால், ஒவ்வொரு வடிவத்திற்கும் தனி linkஐ ஒரு குறிப்பு உடன் சேர்க்கவும். +- ஒரு resource இணையத்தில் பல இடங்களில் இருந்தால்: + - மிக authority உடைய sourceயை பயன்படுத்தவும். + - அவை வெவ்வேறு பதிப்புகளை வழங்கினால், மற்றும் நீங்கள் இந்த பதிப்புகள் போதுமானதாகவே மாறுபடுகின்றன என்று தீர்மானித்தால், ஒவ்வொரு பதிப்பிற்கும் தனி linkஐ குறிப்பு உடன் சேர்க்கவும். (குறிப்பு formatting குறித்த விவாதத்திற்கு [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) ஐ参trik kodupagudan pangukolvathirku). + +- atomic commits (ஒவ்வொரு சேகரிப்பு/நீக்கல்/மாற்றத்திற்கும் ஒரு commit) பெரும் commitsக்கு முன்னுரிமையாய் கொடுக்கவும். PR சமர்ப்பிக்க முன்பு உங்கள் commits ஐ merge செய்ய தேவையில்லை. (maintainers க்கு இது ஒரு வசதிக்காகவே தான், அதனை நாம் வலியுறுத்த மாட்டோம்). +- புத்தகம் பழமையானது என்றால், தலைப்புடன் வெளியீட்டு தேதியை சேர்க்கவும். +- எழுத்தாளரின் பெயர் அல்லது பெயர்கள் பொருத்தமான இடங்களில் சேர்க்கவும். எழுத்தாளர் பட்டியலை "`et al.`" கொண்டு சுருக்கலாம். +- புத்தகம் முடியவில்லை, இன்னும் வேலை செய்யப்படுகிறது என்றால், "`in process`" குறிப்பு சேர்க்கவும், [கீழே விளக்கப்பட்டுள்ள](#in_process)படி. +- resource [*Internet Archive's Wayback Machine*](https://web.archive.org) (அல்லது இதரமுள்ளதின்) மூலம் மீட்கப்பட்டால், "`archived`" குறிப்பு சேர்க்கவும், [கீழே விளக்கப்பட்டுள்ள](#archived)படி. பயன்படுத்த சிறந்த பதிப்புகள் சமீபத்திய மற்றும் முழுமையானதாகவே இருக்கின்றன. +- download செய்ய முன்னர் ஒரு email address அல்லது account setup கேட்கப்பட்டால், மொழி-பொருத்தமான குறிப்புகளை கிளாம்பர்களில் சேர்க்கவும். உதாரணமாக: `(email address *கோரப்பட்டது*, தேவை இல்லை)`. + + +### வடிவமைப்பு + +- எல்லா பட்டியல்களும் `.md` கோப்புகள் ஆகும். [Markdown](https://guides.github.com/features/mastering-markdown/) இலக்கணத்தை கற்றுக்கொள்ள முயற்சிக்கவும். இது எளிது! +- எல்லா பட்டியல்களும் ஒரு সূচியுடன் தொடங்கும். அந்த எண்ணம், அனைத்து பகுதிகள் மற்றும் உட்பாகங்களை அங்கு பட்டியலிட்டு இணைக்கும் என்பதற்கானது. அதை அகரவரிசையில் வைத்திருங்கள். +- பகுதிகள் 3வது நிலை தலைப்புகள் (`###`) பயன்படுத்துகின்றன, மற்றும் உட்பாகங்கள் 4வது நிலை தலைப்புகள் (`####`) பயன்படுத்துகின்றன. + +எப்படி வைத்திருக்க வேண்டும்: + +- கடைசி இணைப்பும் புதிய பகுதியும் இடையே `2` வெற்றிடங்கள் இருக்க வேண்டும். +- தலைப்பு மற்றும் அதன் பகுதியின் முதல் இணைப்பு இடையே `1` வெற்றிடம் இருக்க வேண்டும். +- இரண்டு இணைப்புகளுக்கு இடையே `0` வெற்றிடம் இருக்க வேண்டும். +- ஒவ்வொரு `.md` கோப்பின் முடிவில் `1` வெற்றிடம் இருக்க வேண்டும். + +மாதிரி: + +```text +[...] +* [An Awesome Book](http://example.com/example.html) + (blank line) + (blank line) +### Example + (blank line) +* [Another Awesome Book](http://example.com/book.html) +* [Some Other Book](http://example.com/other.html) +``` + +- `]` மற்றும் `(` இடையே இடைவெளிகள் வைக்காதே: + + ```text + BAD : * [Another Awesome Book] (http://example.com/book.html) + GOOD: * [Another Awesome Book](http://example.com/book.html) + ``` + +- நீங்கள் ஆசிரியரை சேர்க்கும் போது, ` - ` (ஒரு இடைவெளியால் சூழப்பட்ட குறுக்கு இடத்தை) பயன்படுத்தவும்: + + ```text + BAD : * [Another Awesome Book](http://example.com/book.html)- John Doe + GOOD: * [Another Awesome Book](http://example.com/book.html) - John Doe + ``` + +- இணைப்பு மற்றும் அதன் வடிவத்தின் இடையே ஒரு இடைவெளி வைக்கவும்: + + ```text + BAD : * [A Very Awesome Book](https://example.org/book.pdf)(PDF) + GOOD: * [A Very Awesome Book](https://example.org/book.pdf) (PDF) + ``` + +- ஆசிரியர் வடிவத்தை காட்டுவதற்கு முன்பு வருகிறது: + + ```text + BAD : * [A Very Awesome Book](https://example.org/book.pdf)- (PDF) Jane Roe + GOOD: * [A Very Awesome Book](https://example.org/book.pdf) - Jane Roe (PDF) + ``` + +- பல வடிவங்கள் (ஒவ்வொரு வளத்திற்கும் ஒரே இணைப்பை நாங்கள் விரும்புகிறோம். பல வடிவங்களுக்கு எளிய அணுகல் இல்லாத போது, பல இணைப்புகள் பொருத்தமாக இருக்கலாம். ஆனால், நாங்கள் சேர்க்கும் ஒவ்வொரு இணைப்பும் பராமரிப்பு சுமையை உருவாக்குகிறது, எனவே அதை தவிர்க்க முயற்சிக்கிறோம்.): + + ```text + BAD : * [Another Awesome Book](http://example.com/)- John Doe (HTML) + BAD : * [Another Awesome Book](https://downloads.example.org/book.html)- John Doe (download site) + GOOD: * [Another Awesome Book](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) + ``` + +- பழைய புத்தகங்களுக்கு தலைப்பில் வெளியீட்டு ஆண்டு சேர்க்கவும்: + + ```text + BAD : * [A Very Awesome Book](https://example.org/book.html) - Jane Roe - 1970 + GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe + ``` + + - In-process books: + + ```text + GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) *(:construction: in process)* + ``` + +- Archived link: + + ```text + GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* + ``` + + +### அகரவரிசை ஒழுங்கு + +- ஒரே எழுத்தில் தொடங்கும் பல தலைப்புகள் இருக்கும்போது, இரண்டாவது எழுத்தின் அடிப்படையில் ஒழுங்கு செய்திடுங்கள், மேலும் அதன் பிறகும். உதாரணமாக: `aa` என்பது `ab` க்கு முன்பாக வருகிறது. +- `one two` என்பது `onetwo` விற்கு முன்பாக வருகிறது. + +தவறான இணைப்பை காணும் போது, எந்த வரிகளை மாற்ற வேண்டும் என்பதை அறிய, linter பிழை செய்தியைக் காணவும். + + +### குறிப்புகள் + +அடிப்படைச் செயல்முறைகள் எளிதாக இருக்கலாம், ஆனால் நாங்கள் பட்டியலிடும் வளங்களில் பெரும் பல்வகைமை உள்ளது. இந்த பல்வகைமைக்கான சில குறிப்புகள் இங்கே. + + +#### மெட்டாடேட்டா + +எங்கள் பட்டியல்கள் குறைந்த அளவு மெட்டாடேட்டாவை வழங்குகின்றன: தலைப்புகள், URLகள், உருவாக்குபவர்கள், தளங்கள் மற்றும் அணுகல் குறிப்புகள். + + +##### தலைப்புகள் + +- புதிதாக உருவாக்கப்பட்ட தலைப்புகள் இல்லை. நாங்கள் வளங்களிலிருந்தே தலைப்புகளை எடுக்க முயற்சிக்கிறோம்; பங்களிப்பாளர்கள் தலைப்புகளை உருவாக்கவோ அல்லது மறுபரிசீலனைக்காக அவற்றைப் பயன்படுத்தவோ வேண்டாம் எனச் சொல்லப்படுகிறார்கள், இதை தவிர்க்க முடியுமாயின். ஒரு விதிவிலக்காக பழைய படைப்புகளுக்குப் பயன்படுத்தப்படுகிறது; அவை வரலாற்று ஆர்வத்திற்கு மிக முக்கியமானவை என்றால், தலைப்பில் ஆண்டைக் காண்பிப்பதன் மூலம் பயனாளர்களுக்கு அவற்றின் முக்கியத்துவத்தை அறிவிக்க முடியும். +- ALLCAPS தலைப்புகள் இல்லை. பொதுவாக தலைப்பு வழக்கமான எழுத்துருவில் இருக்க வேண்டும், ஆனால் சந்தேகம் ஏற்பட்டால் மூலத்தில் பயன்படுத்திய எழுத்துருவைப் பயன்படுத்தவும். +- எமோஜிகள் இல்லை. + + +##### URLs + +- சுருக்கமான URLக்களை அனுமதிப்பதில்லை. +- URL இலிருந்து தடயமறைவு குறியீடுகள் நீக்கப்பட வேண்டும். +- சர்வதேச URLகள் escaped ஆக இருக்க வேண்டும். உலாவி அடிகளில் Unicode இல் இவை காட்டப்படும், ஆனால் copy-paste செய்து பயன்படுத்தவும். +- பாதுகாக்கப்பட்ட (`https`) URLகள், HTTPS செயல்படுத்தப்பட்டிருந்தால், பாதுகாக்கப்படாத (`http`) URLக்களுக்குப் பதிலாக எப்போதும் விரும்பப்படுகின்றன. +- பட்டியலிட்ட வளத்தை கொண்டிராத, ஆனால் வேறொரு இடத்திற்கு செலுத்தும் URLகளை நாங்கள் விரும்பவில்லை. + + +##### உருவாக்குபவர்கள் + +- இலவச வளங்களின் உரிமையாளர்களை பொருத்தமான போது நாங்கள் நன்றியுடன் குறிக்க விரும்புகிறோம், மொழிபெயர்ப்பாளர்கள் உட்பட! +- மொழிபெயர்க்கப்பட்ட படைப்புகளுக்குப் படைப்பாளர் குறிக்கப்பட வேண்டும். எழுத்தாளர் அல்லாத உருவாக்குபவர்களை குறிக்க [MARC relators](https://loc.gov/marc/relators/relaterm.html) ஐப் பயன்படுத்த பரிந்துரை செய்கிறோம், இக்காட்சியில் காண்பிக்கப்பட்டது போல: + + ```markdown + * [A Translated Book](http://example.com/book.html) - John Doe, `trl.:` Mike The Translator + ``` + + இங்கே, குறிப்பாக `trl.:` என்பது "translator" என்பதற்கான MARC relator குறியீட்டை பயன்படுத்துகிறது. +- ஆசிரியர் பட்டியலில் உள்ள ஒவ்வொரு உருப்படியையும் புலன்கள் மூலம் பிரிக்க ஒரு கமாவை `,` பயன்படுத்தவும். +- ஆசிரியர் பட்டியல்களை "`et al.`" மூலம் சுருக்கலாம். +- உருவாக்குபவர்களுக்கு இணைப்புகளை அனுமதிக்கவில்லை. +- தொகுப்பு அல்லது மறுவாழ்வு படைப்புகளுக்கு, "உருவாக்குபவர்" ஒரு விளக்கத்தை தேவைப்படலாம். உதாரணமாக, "GoalKicker" அல்லது "RIP Tutorial" புத்தகங்கள் "`Compiled from StackOverflow documentation`" எனக் குறிக்கப்படுகின்றன. +- உருவாக்குபவர் பெயர்களில் "Prof." அல்லது "Dr." போன்ற மரியாதைச் சொற்களை நாங்கள் சேர்ப்பதில்லை. + + +##### காலவரையிட்ட பாடநெறிகள் மற்றும் இலவச சோதனைகள் + +- ஆறு மாதங்களில் நாங்கள் நீக்க வேண்டியவைகளை பட்டியலிட முடியாது. +- ஒரு பாடநெறிக்கு ஒரு வரையறுக்கப்பட்ட பதிவு காலம் அல்லது காலநிலை இருந்தால், அதை நாங்கள் பட்டியலிடமாட்டோம். +- ஒரு வரையறுக்கப்பட்ட காலத்திற்கு இலவசமாக வழங்கப்படும் வளங்களை நாங்கள் பட்டியலிட முடியாது. + + +##### தளங்கள் மற்றும் அணுகல் குறிப்புகள் + +- **பாடநெறிகள்.** குறிப்பாக நமது பாடநெறி பட்டியல்களுக்கு, தளம் வள விளக்கத்தின் ஒரு முக்கிய அங்கமாகும். இதன் காரணம், பாடநெறி தளங்கள் வெவ்வேறு வசதிகளையும் அணுகல் மாதிரிகளையும் கொண்டிருக்கும். பதிவு தேவைப்படும் புத்தகங்களைப் பட்டியலிடுவதில்லை, ஆனால் பல பாடநெறி தளங்கள் கணக்கு இல்லாமல் இயங்காது. உதாரண பாடநெறி தளங்களில் Coursera, EdX, Udacity, மற்றும் Udemy அடங்கும். ஒரு பாடநெறி தளத்தில் இயங்கினால், தளப் பெயரை கூறிக்கொள்ள வேண்டும். + +- **YouTube.** பல பாடநெறிகள் YouTube playlists ஆக உள்ளன. நாங்கள் YouTube ஐ ஒரு தளமாக பட்டியலிடவில்லை, YouTube உருவாக்குபவரை பட்டியலிட முயற்சிக்கிறோம், இது பொதுவாக ஒரு துணை தளமாக இருக்கும். + +- **YouTube வீடியோக்கள்.** ஒரு YouTube வீடியோ ஒரு மணி நேரத்துக்கும் மேலாக இருக்கும் பட்சத்தில் மட்டும் நாங்கள் அதை இணைப்பதற்காக நினைப்போம், அது ஒரு பாடநெறி அல்லது டுடோரியல் போல அமைக்கப்பட்டிருக்க வேண்டும். இது இருந்தால், PR விளக்கத்தில் குறிப்பிடுவதற்கு உறுதி செய்யவும். + +- **சுருக்கப்பட்ட (i.e. youtu.be/xxxx) இணைப்புகள் இல்லை!** + +- **Leanpub.** Leanpub புத்தகங்களை பல்வேறு அணுகல் மாதிரிகளுடன் நடத்துகிறது. சில சமயங்களில் புத்தகம் பதிவு இல்லாமல் படிக்கக்கூடியதாக இருக்கும்; சில சமயங்களில் Leanpub கணக்குடன் இலவசமாக அணுக முடியும். Leanpub அணுகல் மாதிரிகளின் தரம் மற்றும் கலவையினை கருத்தில் கொண்டு, பின்னர் பட்டியலிட அனுமதிக்கிறோம், மற்றும் அணுகல் குறிப்பாக `*(Leanpub கணக்கு அல்லது செல்லுபடியான மின்னஞ்சல் தேவையாகும்)*` சேர்க்கப்படுகிறது. + +#### வகைகள் + +ஒரு வளம் எந்த பட்டியலில் சேர வேண்டும் என்பதில் முதன்மையான விதி, வளம் தன்னை எப்படி விளக்குகிறது என்பதைக் காண்பதே. அது தன்னை ஒரு புத்தகமாக அழைத்தால், அது புத்தகம் ஆகலாம். + +##### நாங்கள் பட்டியலிடாத வகைகள் + +இணையம் மிகப் பரந்ததாக இருப்பதால், நாங்கள் பட்டியலிடாதவை: + +- வலைப்பதிவுகள் +- வலைப்பதிவு பதிவுகள் +- கட்டுரைகள் +- இணையதளங்கள் (நாங்கள் பட்டியலிடும் போது, பல உருப்படிகளைத் தொகுத்து கொண்டிருப்பதைத் தவிர). +- பாடநெறிகள் அல்லாத வீடியோக்கள் அல்லது ஸ்க்ரீன்காஸ்டுகள். +- புத்தக அதிகாரங்கள் +- புத்தகங்களில் இருந்து காட்சிகள் +- IRC அல்லது Telegram சேனல்கள் +- Slack சேனல்கள் அல்லது மின்னஞ்சல் பட்டியல்கள் + +எங்கள் போட்டி நிரல் பட்டியல்கள் இவற்றை அதிகமாக பின்பற்றுவதில்லை. சமூகத்தால் வரையறுக்கப்பட்ட இந்த ரெப்போவின் எல்லையை மாற்ற அல்லது புதிய வகைகளை சேர்க்க முன்மொழைய விரும்பினால், ஒரு பிரச்சினையை முன்மொழியவும். + +##### புத்தகங்கள் மற்றும் பிறவற்றுக்கு இடையிலான வேறுபாடு + +ஒரு வளம் புத்தகமாக இருக்க வேண்டியதாகக் கவலைப்படுவதில்லை. ஒரு வளம் ஒரு புத்தகமாக இருப்பதைக் குறிக்கும் சில பண்புகள் இங்கே: + +- இது ஒரு ISBN (சர்வதேச நிலையான புத்தக எண்) கொண்டுள்ளது +- இது ஒரு உள்ளடக்க அட்டவணை கொண்டுள்ளது +- பதிவிறக்கக்கூடிய பதிப்பு (குறிப்பாக ePub கோப்புகள்) வழங்கப்படுகிறது +- இது பதிப்புகளை கொண்டுள்ளது +- இது தொடர்புடைய உள்ளடக்கம் அல்லது வீடியோக்களை நம்புவதில்லை +- இது ஒரு பொருளை முழுமையாக ஆராய்கிறது +- இது தன்னிறைவு அடைந்தது + +இவை இல்லாத பல புத்தகங்களையும் நாங்கள் பட்டியலிடலாம்; சூழ்நிலைப் பொறுத்து இது மாறக்கூடும். + +##### புத்தகங்கள் மற்றும் பாடநெறிகள் + +சில சமயங்களில் இவற்றை வேறுபடுத்த மிகவும் கடினமாக இருக்கும்! + +பாடநெறிகளில் பங்குதார்புக்களும் இருப்பதுண்டு, நாங்கள் அவற்றை புத்தக பட்டியலில் பட்டியலிடுவோம். பாடநெறிகள் விளக்கங்கள், பயிற்சிகள், தேர்வுகள், குறிப்புகள் அல்லது பிற கற்றல் உதவிகளை கொண்டிருக்கின்றன. ஒரு சுயலேசனமான விளக்கம் அல்லது வீடியோ மட்டுமே ஒரு பாடநெறியாக இருக்காது. ஒரு PowerPoint ஒரு பாடநெறியாக இருக்காது. + +##### இடையிலான டுடோரியல்ஸ் மற்றும் பிறவற்றுக்கு இடையிலான வேறுபாடு + +நீங்கள் அதை அச்சிட்டு அதன் சாரத்தைப் பாதுகாக்க முடிந்தால், அது ஒரு இடையிலான டுடோரியல் அல்ல. + +### தானியங்குதல் + +- வடிவமைப்பு விதிகள் நடைமுறைப்படுத்தல் [GitHub Actions](https://github.com/features/actions) மூலம் தானியங்கமாகக் கட்டுப்படுத்தப்படுகிறது, [fpb-lint](https://github.com/vhf/free-programming-books-lint) ஐப் பயன்படுத்துகிறது (மேலும் பார்க்க [`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml)). + +- URL சரிபார்ப்பு [awesome_bot](https://github.com/dkhamsing/awesome_bot) ஐ பயன்படுத்துகிறது. + +- URL சரிபார்ப்பை இயக்க, commit செய்தல் செய்தியில் `check_urls=file_to_check` என்று குறிப்பிட்டு commit ஐ push செய்யவும்: + + ```properties + check_urls=free-programming-books.md free-programming-books-en.md + ``` + +- சரிபார்க்க வேண்டிய கோப்புகளை குறிப்பிடும் போது, ஒவ்வொரு கோப்பையும் இடைவெளி (space) மூலம் பிரிக்கலாம். +- ஒன்றுக்கு மேற்பட்ட கோப்புகளைச் சேர்த்தால், கட்டமைப்பின் (build) முடிவுகள் இறுதியாக சரிபார்க்கப்படும் கோப்பின் அடிப்படையில் இருக்கும். இது காரணமாக பச்சை நிறத்தில் (passing green builds) முடிவு காணப்படும், எனவே Pull Request முடிவில் “Show all checks” -> “Details” என்பதைக் கிளிக் செய்து, கட்டமைப்பின் பதிவுகளை சரிபார்க்க உறுதிசெய்யவும். \ No newline at end of file diff --git a/docs/README.md b/docs/README.md index 5a6a05df5e9b8..c875dd69ef092 100644 --- a/docs/README.md +++ b/docs/README.md @@ -124,6 +124,7 @@ Volunteers have translated many of our Contributing, How-to, and Code of Conduct - [Contributing](CONTRIBUTING-sv.md) - [How-to](HOWTO-sv.md) - Tamil / தமிழ் + - [Contributing](CONTRIBUTING-ta.md) - [How-to](HOWTO-ta.md) - Telugu / తెలుగు - [Code of Conduct](CODE_OF_CONDUCT-te.md)