Add Sanskrit translation : best-practices.md

_articles/sa/code-of-conduct.md

@@ -0,0 +1,70 @@
+---
+lang: sa
+title: "आचारसंहिताः"
+description: "समुचित आचारविधयः स्वीक्रियते चेत् समुदायस्य स्वस्थं तथा रचनात्मकं आचरणं प्रसरीकर्तुं शक्यते।"
+class: coc
+order: 8
+image: /assets/images/cards/coc.png
+related:
+  - building
+  - leadership
+---
+
+## किमर्थं आचारसंहितां योजयेत्?
+
+आचारसंहिता इति एकः दस्तावेयः यः परियोजनस्य सहभागिभ्यः अपेक्षितं आचरणम् निर्दिशति। आचारसंहितां स्वीक्रियित्वा तद् पालनं च कृत्वा भवन्तु समुदायस्य मध्ये सकारात्मकं सामाजिकपरिसरं सृष्टुं शक्यते।
+
+आचारसंहिताः केवलं सहभागिभ्यः पुनर्य न रक्षन्ति, किन्तु परियोजना-परिचालकस्य अपि सुरक्षा वर्धयन्ति। यदि भवतः परियोजनम् परिचालयति, अनुत्पादकमन्येषां दृष्टिकोनाः दीर्घे कालाद् आपदां दातुं शक्नुवन्ति।
+
+आचारसंहिता भवतः समुदायस्य स्वस्थम्, रचनात्मकम् आचरणं प्रवर्तयितुं शक्तिम् ददाति। पूर्वसंग्रहेण नीति-स्पष्टता भवति यत् भवतः वा अन्येषां परियोजना-कार्ये क्लान्तिः न जायेत्, तथा यदि कश्चन अपर्यायं कृते तर्हि तस्मात् शीघ्रं कृत्यं स्वीकरोति।
+
+## आचारसंहितायाः संस्थापनम्
+
+यथाशक्ति शीघ्रं आचारसंहितां स्थापयतु — आदर्शतः यदा प्रथमं परियोजनं निर्माति।
+
+आपेक्ष्याः व्याख्यायै अपि, आचारसंहिता निम्नान् विषयान् निर्दिशति:
+
+* कुत्र आचारसंहिता प्रावर्तते (केवलं इश्यू तथा पुल-रिक्वेस्ट् मध्ये वा समुदाय-कार्यक्रमेषु अपि?)
+* केषां प्रति आचारसंहिता लागू भवति (समुदायस्य सदस्याः वा परिचालकाः, प्रायोजकाः च कथम्?)
+* यदि कश्चन आचारसंहितां उल्लङ्घयति तर्हि का प्रक्रिया अस्ति
+* कोऽपि कथं उल्लङ्घनानि प्रतिवेदयेत्
+
+यत्र शक्यं तत्र पूर्व-प्रतिमानान् (prior art) अनुगच्छतु। [Contributor Covenant](https://contributor-covenant.org/) इत्यादि बहुषु मुक्तस्रोतपरियोजनासु उपयुक्ता आचारसंहिता अस्ति।
+
+परियोजनस्य मूलरूपे `CODE_OF_CONDUCT` नामकं दस्ता‍वेज् स्थापयित्वा तस्य सङ्ग्रहणं `CONTRIBUTING` वा `README` मध्ये लिङ्क् कृत्वा दृश्यं करोतु।
+
+## आचारसंहितायाः प्रवर्तन-नीतिः निर्धारितु
+
+आचारसंहितायाः पालनं कथं करिष्यते इति पूर्वमेव स्पष्टं करोतु। एषा प्रक्रिया आवश्यकम् अस्ति यतः:
+
+* यदा कार्यं आवश्यकं तदा त्वं गम्भीरः असि इति प्रदर्शनं भवति।
+* समुदायः अधिकं निश्चिन्तः भवति यत् प्रतिवेदनानि सम्यक् परीक्षणेन समीकृतानि भवन्ति।
+* समिक्षा-प्रक्रिया न्यायपूर्णा च पारदर्शकः इति आश्वासनं ददाति।
+
+लघु वा गोपनीयपथेन (उदाहरणार्थ ईमेल्) रिपोर्ट् गन्तुम् मार्गं दत्तुम् युक्तम्, तथा कथं रिपोर्ट् प्राप्तः अस्ति तद् स्पष्टं कर्तव्यम्।
+
+## आचारसंहितायाः प्रवर्तनम् {#enforcing-your-code-of-conduct}
+
+यदा कदाचित् कश्चन आचारसंहितायाः उल्लङ्घनं कथयति तदा तस्य समाधानाय विभिन्नाः उपायाः सन्ति।
+
+### परिस्तिथि-विश्लेषणं कुर्व
+
+प्रत्येकस्य समुदायस्य सदस्यस्य वाच्यं महत्वपूर्णम् इव गृह्णीयात्। यदा कश्चन उल्लङ्घनस्य प्रतिवेदनं प्राप्तम्, तर्हि तत्र सम्यक् अनुसन्धानं करोतु। तेन समुदाये भवतः निर्णये विश्वासः वर्धते।
+
+### यथोचितं कर्म करोतु
+
+परिस्थितिः अवलोक्य यथोचितानि निर्णयानि गृह्यन्ते — सार्वजनिकतया चेत् सूचितं, निजतया चेत् समुपदेशनं, वा आवश्यकतया तात्कालिक-निषेधः।
+
+यदि विस्मरणीयम् वा पुनरावृत्तं व्यवहारः आसीत् तर्हि अधिकं प्रबलानि उपायाः (अल्पकालिक-प्रतिबन्धः, दीर्घकालिक-प्रतिबन्धः) अपि ग्रह्यन्ते।
+
+## परिचालकस्य उत्तरदायित्वम्
+
+आचारसंहिता केवलं कागदं न भवेत् — तस्य पालनम् सुनिश्चितं करणीयम्। परिचालकः आचारसंहितायाः नियमाः स्थापयति तथा तान् समाननियमेन साधयितुं उत्तरदायित्वं वहति।
+
+यदि प्रतिवेदनं यथा उल्लङ्घनम् न स्यात् इति निर्णेतुं तर्हि स्पष्टं प्रत्युत्तरं दत्त्वा कारणम् सूचयतु।
+
+## यत् वाञ्छसि तत् आचरणं प्रोत्साहयतु
+
+यदि परियोजना विरूपं वा नास्वीकृतं इति दृश्यते तर्हि योगदानकर्तॄणाम् दूर्यम् भवति। अतः स्वागतकरं वातावरणं स्थापयित्वा समुदायस्य वृद्ध्यर्थं प्रयत्नः कुर्यात्।
+
+---

_articles/sa/finding-users.md

@@ -0,0 +1,35 @@
+---
+lang: sa
+title: "परियोजनस्य उपयोगकर्तॄणाम् अन्वेषणम्"
+description: "तव मुक्तस्रोत् परियोजनायाः सुखेन उपयोगकर्तॄणाम् समागमनस्य मार्गाः।"
+class: finding
+order: 3
+image: /assets/images/cards/finding.png
+related:
+  - beginners
+  - building
+---
+
+## प्रचारस्य आरम्भः
+
+परियोजनस्य उपयोगकर्तॄणां प्राप्तौ स्पष्टं लक्ष्यम् आवश्यकम्। यदि परियोजना दृश्यं न भवति तर्हि उपयोगकर्तृ संख्या न वर्धते। प्रथमं तु, परियोजनस्य उद्देश्यम् संक्षेपेण लिखतु — कः समस्या समाप्नोति, कः लाभः, तथा किम् अपेक्षितम्।
+
+## संदेशं लक्षितु
+
+तव सन्देशः लक्ष्य-समूहाय स्पष्टः भवेत्। उदाहरणतः डेवलपर्-उपयोगिनः, अन्तिम-उपयोगिनः, वा डिज़ाइनर्; प्रत्येकेषां कारणानि भिन्नानि। तदनुसारं च चैनल् (Stack Overflow, Reddit, Hacker News) च उपयोगयतु।
+
+## केन्द्रिकृतम् गृहपृष्ठम् स्थापयतु
+
+स्पष्टः "होम" URL वा स्यान्वय-स्थलम् अस्तु यत्र उपयोगकर्तॄणः शीघ्रं परियोजनस्य प्रयोगं आरम्भयन्ति। यदि वेबसाइट् नास्ति तर्हि GitHub पृष्ठे प्रयोगात्मक README वा सरलं डेमो पृष्ठं दत्तु।
+
+## समुदाय-संवादः आरभतु
+
+प्रचारं केवलं घोषणा न कुर्व — समुदायस्य समस्या समाधानाय मूल्यं प्रदातु। प्रश्नानां उत्तरम् दत्तु, सहयोगसूत्राणि प्रदर्शय, तथा योगदानकर्तॄणां स्वागतं कुरु।
+
+## ऑफलाइन क्रियाः
+
+स्थानीय-सम्मेलनानि, कार्यशालाः च परियोजनस्य दृश्यतां वर्धयन्ति। वक्तृत्वं वा डेमो प्रस्तुतीं दातु, लोकान् आकर्षयतु।
+
+## धैर्यं धारयतु
+
+परियोजनस्य प्रसारः कालेन भवति। नियमितानि प्रयत्नानि कुर्वन् सम्बन्धान् निर्मातुम् प्रयत्नः कुरु।

_articles/sa/getting-paid.md

@@ -0,0 +1,32 @@
+---
+lang: sa
+title: "वित्तलाभः: मुक्तस्रोत् कार्यार्थं"
+description: "परियोजनस्य कालिक-जीवित्वाय वित्तसमर्थनस्य विकल्पाः परिमर्श्यन्ते।"
+class: getting-paid
+order: 7
+image: /assets/images/cards/getting-paid.png
+related:
+  - best-practices
+  - leadership
+---
+
+## कुतः वित्तलाभः अपेक्षितः
+
+यदा परियोजनस्य परिचालनार्थं आवश्यक-समयः तथा स्रोताः स्वल्पाः स्युः, तदा वित्तलाभः परियोजनस्य दीर्घजीवित्वे साहाय्यं करोति। वित्तसमर्थनं दातुं लोकाः अनेकान्यर्थान् रखन्ति — शीघ्र-समाधानस्य अपेक्षा, विकासस्य तेजत्वं वा परियोजनस्य स्थिरतायाः आशा।
+
+## विकल्पाः
+
+* **दानम्:** GitHub Sponsors, Open Collective, Patreon इत्यादीनि माध्यमानि।
+* **प्रायोजकता:** संस्थानैः वा व्यवसायैः सहयोगं लभित्वा प्रत्यक्षः अर्थसहाय्यः।
+* **ग्रान्ट्:** अनुदान-निधयः परियोजनस्य विशिष्ट-कार्याणि समर्थयन्ति।
+* **व्यवसायिक-समर्थनम्:** पेशेवर् सेवाः (कन्सल्टिंग्, प्रायोगिक-सपोर्ट्) वितरणेन आयः लभ्यते।
+
+## पारदर्शिता आवश्यकी
+
+यत् धनं समागतम् तस्य प्रयोगस्य स्पष्ट-लेखनी अनिवार्यं। खर्च-रिपोर्ट्, समर्थन-नीतिः च समुदायस्य विश्वासं रक्षति।
+
+## अपेक्षाः व्यवस्थापयतु
+
+यदि वित्तसमर्थनं स्वीकार्यते तर्हि योगदानकर्तॄणां अपेक्षाः स्पष्टतया लिखिताः भवन्तु — कोन कार्येषु धनं उपयुज्यते, तथा विज्ञापन-निर्देशाः वा व्यापारिक-संघटनस्य प्रभावः कथम् स्युः।
+
+एवं कुर्वन् वित्तलाभेन परियोजनस्य दायित्वं सुगमं कृत्वा दीर्घकालिकं कार्यं संरक्ष्यते।

_articles/sa/how-to-contribute.md

@@ -0,0 +1,37 @@
+---
+lang: sa
+title: "योगदानं कथं कर्तव्यं"
+description: "नवयोगदानकर्तृभ्यः अनुभवीभ्यश्च मुक्तस्रोत् योगदानस्य मार्गदर्शिका।"
+class: contribute
+order: 1
+image: /assets/images/cards/contribute.png
+related:
+  - beginners
+  - building
+---
+
+## आरम्भः
+
+यदि त्वं मुक्तस्रोत् परियोजनायाः योगदानं कर्तुम् इच्छसि तर्हि प्रथमं README पठतु, यथा "CONTRIBUTING" वा "Good first issue" इति सूचनाः सन्ति। लघु समस्यासु नागरिकता आरभ्य, छोटे सुधाराणि दातु, पृष्ठीयदोषान् सुधर।
+
+## योगदानस्य प्रकाराः
+
+* **कोड् लेखनम्:** बग्-समाधानम्, नवीनीकरणम्, परीक्षण-लेखनम्।
+* **दस्तावेजीकरणम्:** README, उपयोग-निर्देशाः, उदाहरणम् च।
+* **डिजाइन्:** UI/UX सुझावाः, लोगो, ग्राफिक्।
+* **अनुवादः:** परियोजनस्य बहुभाषीयता वर्धयतु।
+
+## योगदान आरम्भ कर्तुम्
+
+1. उज्ज्वलं समस्या-अन्वेषणं कुरु (issue)।
+2. लघु-प्रस्तावेन PR पठयतु।
+3. परीक्षणानि यथासंभवं समायोजय।
+4. स्पष्ट-सन्देशः दीयताम् (PR description)।
+
+## समुदाय-सहयोगः
+
+सौजन्यं, धैर्यं च धृत्वा संवादं कुरु। यदि निर्देशाः अस्पष्टाः सन्ति तर्हि विनम्रतया पूरकप्रश्नान् पृच्छ। प्रविष्टिः न पश्यताम् चेत् सहकार्ये साधारण-कार्यं निर्दिश।
+
+## इव कार्यक्रमान् आयोजय
+
+स्थानीय-मिटीङ्ग् वा ऑनलाइन-कार्यशाला आयोज्य परियोजनस्य उपयोगित्वं विस्तरयतु। नवसदस्यान् आमन्त्रयतु तथा मार्गदर्शनं दातु।

_articles/sa/index.html

@@ -0,0 +1,6 @@
+---
+layout: index
+lang: sa
+title: मुक्तस्रोत मार्गदर्शिका
+permalink: /sa/
+---

_articles/sa/leadership-and-governance.md

@@ -0,0 +1,29 @@
+---
+lang: sa
+title: "नेतृत्वं च शासन-प्रणाली"
+description: "वृद्धिमान् मुक्तस्रोत् परियोजनाः निर्णयोपायेषु सङ्गठितनियमैः लाभान् उपलभन्ते।"
+class: leadership
+order: 6
+image: /assets/images/cards/leadership.png
+related:
+  - best-practices
+  - metrics
+---
+
+## वृद्धिमत् परियोजनायाः शासन-ज्ञानम्
+
+यदा परियोजनः वृध्दिं याति तथा लोकाः सम्मिलन्ते, तदा परियोजनस्य संचालनाय औपचारिक-नीतयः उपयोगी भवन्ति। एतेन योगदानकर्तृणां भूमिकाः स्पष्टाः स्युः तथा निर्णय-प्रक्रियायाः पारदर्शिता वर्धते।
+
+## पारंपरिकभूमिकाः काः स्युः?
+
+बहूनि परियोजनानि योगदानकर्तृ-भूमिकानां संस्कृतम् अनुसरन्ति। किञ्चन सामान्य-भूमिकाः:
+
+* **परिचालकः (Maintainer)**
+* **योगदानकर्तृ (Contributor)**
+* **कमिटर् (Committer)**
+
+परिचालकः कदाचित् केवलं कोड् लेखकः न भवेत्; सः परियोजनस्य प्रचारकः, दस्तावेज-लेखकः च भूत्वा परियोजनस्य दिशा-भावे उत्तरदायित्वं वहति।
+
+योगदानकर्तृ इति सर्वः स्यात् यस्य यथाकिञ्चन योगदानं भवति — इश्यू-ट्रायजिङ्, कोड्, वा कार्यक्रम-आयोजनम् अपि।
+
+एवमेव पारदर्शिता, भूमिकानाम् स्पष्टता च समुदायस्य दीर्घस्थायित्वाय आवश्यकम्।