diff --git a/_articles/sa/best-practices.md b/_articles/sa/best-practices.md new file mode 100644 index 00000000000..725c0304b3f --- /dev/null +++ b/_articles/sa/best-practices.md @@ -0,0 +1,180 @@ +--- +lang: sa +title: परिचालकानां श्रेष्ठः आचरणः +description: मुक्तस्रोतपरियोजनायाः परिचालकः स्यात् चेत् प्रक्रियासु लेखनात् समुदायस्य उपयोगपर्यन्तं, तस्य जीवनं सुकरं भवति। +class: best-practices +order: 5 +image: /assets/images/cards/best-practices.png +related: + - metrics + - leadership +--- + +## एकं परिचालकः भवितुं का अर्थः? + +यदि भवान् एषां बहुसंख्यकानां उपयोगे येषां मुक्तस्रोतपरियोजनां परिचालयति, तर्हि सः दृष्टुम् अर्हति यत् भवतः समयः कूटलेखनाय न्यूनं गच्छति, परन्तु समस्यासु प्रतिसादाय अधिकं व्यतीतेति। + +परियोजनायाः प्रारम्भिकावस्थायाम्, भवान् नवीनविचारैः प्रयोगं कुर्वन् इच्छातनुसारं निर्णयान् गृह्णाति। परियोजनायाः लोकप्रियता वर्धमानस्य, भवतः अधिकं उपयोगकर्तृभिः सह योगदानकर्तृभिः च सहकार्यं सुलभं भवति। + +परियोजनायाः परिचालनं केवलं कूटलेखनं न भवति। एते कार्याणि अकस्मात् प्रकटितानि भवन्ति, परन्तु ते विकासशीलपरियोजनायैव महत्त्वपूर्णानि भवन्ति। प्रक्रियाणां दस्तावेजकरणात् समुदायस्य उपयोगपर्यन्तं, जीवनं सुलभं करणीयं विकल्पानि अस्माभिः संकलितानि सन्ति। + +## प्रक्रियाणां दस्तावेजकरणम् + +लेखनं करणं एकं महत्त्वपूर्णं कर्म भवति यत् एकस्य परिचालकस्य। + +दस्तावेजकरणं केवलं स्वविचाराणां स्पष्टिं न ददाति, किन्तु अन्ये अपि जानन्ति यत् भवतः अपेक्षा किं, यावत् ते पृच्छन्ति, पूर्वमेव। + +लेखनं करणं यदा किञ्चित् स्वविस्तरे न सुसंगतम्, तदा निषेधं कथयितुं सुगमं करोति। तथा च, अन्ये अपि सहाय्यं दातुं सुलभं भवति। न जानाति कः भवतः परियोजनं पठति वा उपयोगयति। + +पूर्णपाठानां उपयोगं न कृत्वा अपि, बुलेट् बिन्दूनि लिखित्वा तस्य लेखनं उत्तमं भवति। + +सदा दस्तावेजं अद्यतनं कुर्वीत। यदि न शक्नोति, तर्हि पुरातनं दस्तावेजं मुञ्चतु अथवा पुरातनत्वं सूचयतु यथा योगदानकर्तृभिः अद्यतनीकरणं कर्तुं जानन्ति। + +### परियोजनायाः दृष्टिपथं लिखतु + +परियोजनायाः लक्ष्याणि लिखित्वा आरभत। तान् README मध्ये समावेशयतु, अथवा पृथक् `VISION` इत्यस्मिन् फाइल् निर्मातु। यदि अन्यानि साधनानि सहायकानि, यथा परियोजनारूपरेखा, तानि अपि सार्वजनिकानि कुर्वीत। + +स्पष्टं, दस्तावेजीकृतं दृष्टिपथं धारयित्वा, भवतः केन्द्रितं कुर्वन् अन्यैः योगदानैः "विस्तारापेक्षायाः" बाधां टालयति। + +उदाहरणार्थ, @lord ज्ञातवान् यत् परियोजनादृष्टिपथं प्राप्तेन समयव्ययाय कस्याः विनियोगे निर्देशः कर्तुं शक्यते। नूतनपरिचालकस्य रूपेण, तस्य प्रथमं सुविधायाः विनियोगे [Slate](https://github.com/lord/slate) सम्बन्धिनि, तस्य परियोजनाविस्तारे न अडिग् स्थितः, एतत् पश्यन् खेदं जातम्। + + + +### अपेक्षाः सञ्चरतु + +नियमाः लिखितुं कठिनाः स्युः। कदाचित् इदं अन्येण नियन्त्रणं इव वा सर्वं रमणीयं नष्टं इव मन्यसे। + +यथासंभवम् लिखितं न्याययुक्तं च, उत्तमः नियमः परिचालकान् सशक्तं करोति। एतेन भवतः अनिच्छितकार्ये प्रविष्टिं रोद्धुं शक्यते। + +बहवः ये परियोजनं दृष्टवन्ति, ते स्वस्य परिस्थितीनां विषयं न जानन्ति। ते मन्यन्ते यत् भवान् तस्मिन् कर्मणि वित्तं लभते, विशेषतः यदि तं नियमितं उपयोगयन्ति। कदाचित् भवान् पूर्वं समयं परियोजनायाम् व्यतीतवान्, परं अद्य नवकर्म वा परिवारस्य कारणेन व्यस्तः। + +सर्वं यथावत् योग्यं! केवलं अन्ये जानन्तु इति सुनिश्चितं कुर्वीत। + +यदि परियोजनायाः परिचालनं अंशकालिकं वा स्वयंसेवी अस्ति, तदा स्वस्य समयस्य स्पष्टं विवरणं दत्तम्। एतत् परियोजनायाः आवश्यकसमयस्य वा अन्येषां अपेक्षायाः तुल्यम् न अस्ति। + +लेखनीयानि किञ्चित् नियमाः: + +* योगदानस्य समीक्षां च स्वीकृतिं कथं कुर्वीथाः (_परीक्षाः आवश्यकाः? समस्या साँचे?_ ) +* ये योगदान प्रकाराः स्वीकरिष्यन्ति (_केवलं कूटस्य विशेषभागे सहाय्यं इच्छसि?_ ) +* अनुवर्तीकरणाय कदा उचितम् (_उदाहरणार्थ, "परिचालकात् ७ दिनेषु प्रत्युत्तरं अपेक्ष्यम्। यदी न श्रुतम्, तर्हि थ्रेड् पिङ् कर्तुं स्वतंत्रः"_ ) +* परियोजनायाम् समयव्ययः कथं (_उदाहरणार्थ, "सप्ताहे केवलं ५ घण्टानि व्यतीताः"_ ) + +[Jekyll](https://github.com/jekyll/jekyll/tree/master/docs), [CocoaPods](https://github.com/CocoaPods/CocoaPods/wiki/Communication-&-Design-Rules), [Homebrew](https://github.com/Homebrew/brew/blob/bbed7246bc5c5b7acb8c1d427d10b43e090dfd39/docs/Maintainers-Avoiding-Burnout.md) परियोजनासु परिचालकानां योगदानकर्तृभ्यः नियमानाम् उदाहरणानि सन्ति। + +### सञ्चारं सार्वजनिकं धारयतु + +सम्बन्धानां लेखनं न विस्मर्तव्यम्। यत्र सम्भवम्, परियोजनासम्बन्धः सार्वजनिकं भवतु। यदि कश्चन निजपणे सम्पर्कं कर्तुं प्रयासति, तं सौम्यतया सार्वजनिकसञ्चारचैनल् इव निर्देशयतु, यथा मेलिंग् सूची वा समस्या ट्रैकर्। + +यदि अन्यपरिचालकैः सह मिलति वा गूढ निर्णयं करोति, तदा अपि सार्वजनिके लिखित्वा संज्ञानं दातुं नोट्स् प्रकाशितं कुर्वीत। + +एवं यः कोऽपि समुदायं आगच्छति, सः पूर्ववर्षेभ्यः समानं सूचना प्राप्नोति। + +## निषेधं कथयितुं शिक्षितु + +भवान् लेखितवान्। यथाशक्ति, सर्वे पाठकाः दस्तावेजं पठेयुः, परन्तु वास्तव्यात्, अन्यान् स्मारयितुं आवश्यकं भविष्यति। + +सर्वं लिखितं भवति चेत्, नियमं प्रवर्तयतः व्यक्तित्वान् न्यूनं करोति। + +निषेधं कथयितुं रमणीयं न, परन्तु _"भवत् योगदानं परियोजनस्य मापदण्डानुसारेण नास्ति"_ इत्यादि व्यक्तित्वन्यूनं अनुभूयते। + +निषेधं बहुषु परिस्थितिषु लागू भवति: सुविधायाः विनियोगः यः दायरा न योजयति, चर्चां विचलयन्, अन्येषां व्यर्थकर्म। + +### संवादं मैत्रीयं धारयतु + +निषेधं अभ्यासाय मुख्यः स्थलं भवतः समस्या च पुल् अनुरोध सूची। परिचालकस्य रूपेण, सुझावाः आगच्छन्ति ये स्वीकरितुम् न इच्छसि। + +कदाचित् योगदानं परियोजनायाः दायरा परिवर्तयति वा दृष्टिपथं न अनुगच्छति। कदाचित् विचारः उत्तमः, परन्तु क्रियान्वयनं नीचम्। + +यदा योगदानं न स्वीक्रियते, तदा प्रथमं प्रतिक्रिया विस्मर्तुं वा न दृष्टवान् इव कर्तुं शक्यते। एतत् अन्यस्य हृदयस्पर्शं कुर्यात् च समुदायस्य अन्य योगदानकर्तृभ्यः प्रेरणाहानिं करोति। + + + +अवांछित योगदानं सदा न खोलतु। समये, अप्रत्युत्तरितानि समस्याः तथा पुल् अनुरोधाः परियोजनायाम् कार्यं अधिकं क्लेशकरं कुर्वन्ति। + +यथासंभवम् त्वरितं न स्वीक्रियतानि योगदानानि समापयतु। यदि परियोजनायाम् विशालं बैकलॉग् अस्ति, @steveklabnik सुझावः दत्तः [समस्या दक्षतया वर्गीकर्तुं](https://words.steveklabnik.com/how-to-be-an-open-source-gardener)। + +द्वितीयतः, योगदानं उपेक्षितं समुदायाय नकारात्मकं संदेशं प्रेषयति। परियोजनायाम् योगदानं भयजनकं, विशेषतः प्रथमवारं यदि योगदानकर्तृ अस्ति। अपि यदि न स्वीक्रियते, तस्य प्रयासं मानयतु च आभारं कथयतु। महत् प्रशंसा। + +यदि योगदानं न स्वीक्रियेत: + +* **आभारं दत्तुम्** +* **किं कारणं दायरा न अनुगच्छति** स्पष्टं कथयतु, सुधारस्य सुझावः दत्तुम्। स्नेहपूर्णं, परन्तु दृढम्। +* **संबद्ध दस्तावेजं लिङ्क् कुरुत**, यदि अस्ति। आवृत्तिपूर्वक अनुरोधं रोद्धुम्। +* **अनुरोधं समापयतु** + +१–२ वाक्यानि पर्याप्तानि। उदाहरणार्थ, [celery](https://github.com/celery/celery/) Windows समस्या, @berkerpeksag [प्रतिक्रियां](https://github.com/celery/celery/issues/3383) दत्तवान्: + +![Celery screenshot](/assets/images/best-practices/celery.png) + +यदि निषेधस्य विचारः भयंकरः, न एकः। @jessfraz [इव](https://blog.jessfraz.com/post/the-art-of-closing/) कथयति: + +> बहूनि मुक्तस्रोतपरियोजनानां परिचालकैः संभाषितम्, Mesos, Kubernetes, Chromium, सर्वे अभिमतम् यत् परिचालकस्य कठीनतमं अंशं, "न" कथयितुं इच्छितपैचपत्रेषु। + +अन्यस्य योगदानं न स्वीक्रियते इति दुःखं न अनुभवतु। मुक्तस्रोतस्य प्रथमः नियमः, @shykes [इव](https://twitter.com/solomonstre/status/715277134978113536): _"न अस्थायी, हाँ शाश्वत"_। अन्यस्य उत्साहं सहानुभूति, योगदानं अस्वीकृतिः व्यक्तित्वस्य अस्वीकृतिः न अस्ति। + +अन्ते, यदि योगदानं पर्याप्तं न, स्वीक्रियति अनिवार्यम् न। स्नेहम्, उत्तरदायित्वं प्रदत्तु, केवलं यत् परियोजनं सुधारयिष्यति स्वीक्रियतु। यथासंख्यं अभ्यासः निषेधस्य, तस्मात् सरलम् भवति। प्रतिज्ञा। + +### सक्रियः भवतु + +अवांछित योगदानस्य मात्रा न्यूनं कर्तुं, परियोजनायाः योगदानपद्धतिं स्पष्टं कथयतु। + +यदि निम्नगुणस्तरस्य योगदानं आगच्छति, योगदानकर्तृभ्यः पूर्वं किञ्चित् कार्यं आवश्यकं कृत्वा, उदाहरणार्थ: + +* समस्या वा पुल् अनुरोध साँचे/सूची पूरयतु +* पुल् अनुरोधात् पूर्वं समस्या उद्घाटयतु + +नियमं न पालयन्ति चेत्, समस्या त्वरितं समाप्यतु च दस्तावेजं सूचयतु। + +यद्यपि प्रथमं कठोरं, सक्रियता दुष्टं न, परस्परयोः हितकरम्। अनावश्यककाले योगदानं व्यर्थं कार्यं न कुर्वन्ति। भवतः कर्मभारं सुगमं भवति। + + + +कदाचित् निषेधं कथ्यते, योगदानकर्तृ क्रुद्धः भवति। यदि आक्रामकः, [परिस्थितिं शान्तां कुरुत](https://github.com/jonschlinkert/maintainers-guide-to-staying-positive#action-items) वा समुदायात् निष्कासयतु। + +### मार्गदर्शनं स्वीकरोतु + +कदाचित् योगदानकर्तृ परियोजनायाः मानकान् न अनुगच्छति। पुनरपि अस्वीकृतिः क्लेशः कुर्यात्। + +यदि उत्साही, किंतु सुधारस्य आवश्यकता, धैर्यं धारयतु। प्रत्येक स्थितौ स्पष्टतया कारणं कथयतु। सरलः कार्य इव निर्दिष्टम्, यथा _"good first issue"_। समये सः मार्गदर्शनेन सहायः भवतु। + +## समुदायस्य उपयोगं कुर्वीत + +सर्वं स्वयमेव न कर्तव्यं। परियोजनायाः समुदायः अस्ति! यदि सक्रियः समुदायः न, उपयोगकर्तृ बहवः कार्यं दातुं प्रयत्नं कुर्यात्। + +### कार्यभारं वितर + +अन्यैः सहाय्यं अपेक्ष्यते चेत्, प्रथमं पृच्छतु। + +नूतन योगदानकर्तृ प्रोत्साहनाय, [सरल समस्याः चिह्नितान्](https://help.github.com/en/articles/helping-new-contributors-find-your-project-with-labels) कुर्वीत। GitHub प्लेटफॉर्मे दृश्यतां वर्धयति। + +नूतन योगदानकर्तृ निरन्तर योगदानं कुर्वन्, तेषां कार्यं मानयतु। अन्यैः नेतृत्व भूमिकां प्राप्तुं मार्गदर्शनं लिखतु। + +स्वयंकार्यभारस्य न्यूनीकरणाय, अन्यैः परियोजनायाः स्वामित्वं [साझा](../building-community/#share-ownership-of-your-project) प्रोत्साहनं कुर्वीत। @lmccart पश्यत्, [p5.js](https://github.com/processing/p5.js) परियोजनायाम् सफलम्। + + + +यदि परियोजनात् विरामः आवश्यकः, अन्ये स्वीकरोतु। यदि अन्ये उत्साही, तान् commit अधिकारं दत्तु वा औपचारिक नियन्त्रणं हस्तान्तरेण कुरुत। यदि अन्ये fork कुर्वन्ति, लिङ्क् प्रदत्तु। परियोजनायाः जीविताय सर्वे उत्साहिताः! diff --git a/_articles/sa/building-community.md b/_articles/sa/building-community.md new file mode 100644 index 00000000000..99dba2b7781 --- /dev/null +++ b/_articles/sa/building-community.md @@ -0,0 +1,218 @@ +--- +lang: sa +title: "सौम्यसमुदायस्य निर्माणम्" +description: "यः समुदायः लोकान् परियोजनस्य उपयोगे, योगदाने, च प्रचारे प्रोत्साहयति तस्य निर्माणस्य मार्गदर्शिका।" +class: building +order: 4 +image: /assets/images/cards/building.png +related: + - best-practices + - coc +--- + +## परियोजनस्य सफलतायै व्यवथापनम् + +त्वं परियोजनं प्रकाशितवान्, प्रसिद्धिं वितरयसि, च लोकाः तस्य निरीक्षणं कुर्वन्ति। शुभं! त्वमेव चिन्तयसि — तान् कथं दीर्घकालं तत्र स्थातुं प्रेरयिष्यसि? + +स्वागतम् ददाति समुदायः तव परियोजनस्य भविष्ये तथा ख्यात्यै निवेशः अस्ति। यदा तव परियोजनं तस्य प्रथम-योगदानान् प्राप्त्वा आरभते तर्हि प्रारम्भिकयोगदानकर्तृभ्यः सुस्वागतदृष्ट्या अनुभवः दातव्यम् यत् ते पुनरागतुम् इच्छेयुः। + +### लोकान् स्वागतकरान् भवय + +परियोजन-समुदायं चिन्तयताम् यथा @MikeMcQuaid कथयति — योगदानकर्तृ-फनेल् (contributor funnel): + +![Contributor funnel starts with users, then contributors, then maintainers.](/assets/images/building-community/contributor_funnel_mikemcquaid.png) + +यदा त्वं समुदायं निर्मासि तदा फनेल्-ऊपरि (संभावित-उपयोगकर्ता) आरभ्य अधो (सक्रिय-परिचालकः) पर्यन्तम् व्यक्तिः कथं गच्छेत् इति चिन्तय। तव लक्ष्यं प्रत्येकचरणे अडचनो न्यूनम् कर्तुं अस्ति। लोकाः सुलभ-यशस्‍य लभन्ते तदा ते अधिकं कृते प्रेरिताः भवन्ति। + +प्रारम्भं कुरु द्वितीयेन — तव दस्तावेजनेन: + +* **परियोजनं उपयोगं सुकरं कुरु।** सुबोधं `README` तथा स्पष्ट-कोड्-दर्शनम् नवागन्तुकान् शीघ्रं आरभयितुं साहाय्यं करिष्यति। +* **योगदानं कथं कुर्वन्ति स्पष्टं लिख।** `CONTRIBUTING` फाइल्, तथा अद्यतनानि issue-नामानि धारय। +* **Good first issues**: नवयोगदानकर्तृभ्यः आरम्भाय सरलानि कार्याणि `good first issue` इत्यानि लेबल् दत्तुम् चिन्तय। GitHub एतानि विभिन्नस्थले प्रदर्शयिष्यति, यतः सरलनवीन-योगदानानि वर्धन्ते। + +[GitHub 2017 Open Source Survey](http://opensourcesurvey.org/2017/) सूचयति यत् अपूर्णं वा भ्रमजनकं दस्तावेजनं मुक्तस्रोत् प्रयोगकर्तृभ्यः महान् बाधकः अस्ति। सद्-लेखनं लोकान् तव परियोजनस्य अन्तःकर्मणि प्रवर्तयितु आह्वयति। अन्ततः कोऽपि issue वा pull request उद्घाटयिष्यति। एतानि संवादानि फनेल्-अधः गन्तुं अवसराणि भवन्ति। + +* **यदा नवः आगच्छति, तं कृतज्ञतया अभिवादय।** केवलं एकः नकारात्मकः अनुभवः जनान् परित्यगितु प्रेरयति। +* **प्रतिसादशिलतां धारय।** यदि मासे कः एषः प्रश्नं न उत्तरयति तर्हि सः परियोजनं विस्मरति। +* **स्वीकार्ययोग्ययानि योगदानप्रकाराणि स्वीकुर्वः भव।** कतिचन योगदानकर्तारः बग्-प्रतिवेदनात् वा लघु-समाधानात् आरभन्ते। बहूनि प्रकाराः योगदानस्य सन्ति — लोकान् यथेष्टवद् सहाय्यं कर्तुम् अवकाशं ददातु। +* **यदि कस्य योगदानं त्वया अस्वीकृतम् अस्ति, तं कृतज्ञतया धन्यवाद् वचनानि दत्त्वा कारणं स्पष्टं कुरु** तथा यदि उपयुक्तं तर्हि सम्बद्ध-दस्तावेजान् लिङ्क्कुरु। + + + +अधिकांशं योगदानकर्तॄणां पटे 'casual contributors' इति — केवलं अल्पकाले योगदानकर्तारः। एते न पूर्णतया परियोजनम् आत्मनि सम्यग् अवगताः सन्ति; अतः तव कर्तव्यं अस्ति तान् सुलभतया योगदानं कर्तुं योग्यं कर्तुम्। + +अन्ययोर् योगदानस्य उत्प्रेरणेन आत्मनि अपि लाभः भवति। यदि तव समर्थकान् स्वविचारेण कार्यसञ्चालनाय सक्षमं कृत्वा त्यजन्ति तर्हि त्वम् सर्वं कर्तुम् बाध्यः न स्याः। + +### सर्वं लिखitum — सम्पूर्णतया दत्तव्यम् + + + +नवपरियोजनस्य आरम्भे कदाचित् स्वकार्याणि गोपनीयतया धार्यन्ते; परं मुक्तस्रोत् परियोजनाः सार्वजनिक-दस्तावेजनेन जीवन्ति। + +यदा तव कार्याणि लिखितानि भवन्ति तर्हि समागताः बहवः प्रत्येक-संवादे भागं गृह्णन्ति। भवतः अपेक्षायाः, मार्गदर्शकस्य, समीक्षा-प्रक्रियायाः च पारदर्शिता ददातु। + +यदि सादृश्येन बहवः उपयोगकर्तारः एकस्यै समस्यायाः समीपं आगच्छन्ति तर्हि तस्य उत्तरं README मध्ये समये दत्तु। + +मण्डलीनां (meetings) नोट् वा निष्कर्षाणि उक्ते इश्यू इति स्थाप्यन्तु। एषा पारदर्शिता आश्चर्यजनकं प्रतिक्रियाम् आनयति। + +यदि त्वं भविष्ये विस्तीर्णपरिवर्तनम् कर्तुम् प्रतिसन्नः तर्हि ताम् pull request इति स्थापयित्वा WIP (work-in-progress) सूचय — अन्ये अपि प्रक्रमे भागं लभेयुः। + +### शीघ्रतया प्रतिसादं ददातु + +यदा त्वं [परियोजनस्य प्रचारं करोति](../finding-users) तदा जना प्रतिसादं दास्यन्ति। ते प्रश्नान् पृच्छन्ति, मार्गदर्शनम् अपेक्षन्ते वा प्रारम्भे सहाय्यं चाहन्ति। + +यदा त्वम् शीघ्रतया प्रतिक्रिया दासि तर्हि लोकाः संवादस्य भागं इव अनुभवन्ति तथा पुनर्वारं योगदानाय उत्सुकाः स्युः। + +यदि त्वं सम्यक् समीक्षां शीघ्रं न कारयितुं शक्नोषि तर्हि तद् प्रारम्भिक-स्वीकृतेन (acknowledgement) प्रत्यूह्यताम् — इदं सहभागिनः अधिकं प्रेरयति। + +Mozilla अध्ययनम् दर्शयति यत् 48-घण्टेभ्यः अन्तराले समीक्षां प्राप्ताः योगदानकर्तारः पुनरनुभवस्य च योगदानस्य दरः उच्चतरः। + +कदाचित् तव पर्यवेक्षणानि अन्यत्र अपि सन्ति — Stack Overflow, Twitter, Reddit आदि। एतेषु सर्वेषु स्थलैः सूचना-निर्देशं स्थापय, यथा उल्लेखः प्राप्ते त्वम् सूचितः स्याः। + +### समुदायाय स्थानं ददातु + +समुदायाय सार्वजनिक-संवादाय स्थानस्य द्वे कारणे सन्ति। + +प्रथमम् — समुदायस्य स्वयं हेतु। लोकाः परस्परम् अवगताः स्युः। सार्वजनिक-संवादः पुरातनलेखांश् पठित्वा शीघ्रं परिचयं ददाति। + +द्वितीयम् — भवतः निमित्तम्। यदि त्वम् लोकान् निजी-रूपेण प्रत्येक्षं प्रत्युत्तरं दासि तर्हि शीघ्रमेव क्लेशः वर्धते। प्रारम्भे किञ्चित् एकद्वारस्य निजी-सहायतायाः अनुवर्त्ततया स्वीकरोति परन्तु यदा परियोजनः लोकप्रियः भवति तर्हि एषः अहंकारः त्वां क्लान्तं करोतु। अतः जनान् सार्वजनिक-चैनल् प्रति निर्देशयतु। + +सार्वजनिक-संवादस्य सरल मार्गाः — issues उद्घाटय, मेलिङ्-सूची स्थापय, ट्विटर् वा Slack/IRC चैनल् स्थापय। यथासम्भवम् सर्वाणि प्रयोजय। + +Kubernetes kops इव किञ्चन परियोजनानि द्वि-साप्ताहिकं कार्यालय-समयं निधाय नवागन्तुकान् सहाय्यं कुर्वन्ति। + +विशेषः अपवादः — 1) सुरक्षा-सम्बन्धी इश्यू तथा 2) गम्भीर आचार-भंग इत्यादयः गोपनीयतया प्रातिवेदनीयाः भवन्तु। यद्यपि निज-ईमेल् न इच्छसि तर्हि समर्पित-ईमेल्-संस्था स्थापयतु। + +## समुदायस्य वृध्दिः + +समुदायाः महत्त्वपूर्णाः शक्तियुक्ताः सन्ति। एषा शक्तिः निर्माणाय वा विनाशाय प्रयुक्तुम् शक्यते — तस्मात् त्वया विवेकपूर्वकं सञ्चालयतु। + +### दुष्ट-व्यक्तीन् न सह्यतां दत्तु + +यः अपि लोकप्रियः परियोजनः जनान् आकर्षति, ते मध्ये कश्चन जनाः अपकारी कार्याणि कुर्वन्ति — विवादाः आरभन्ति, लघु विषयेषु खण्डनं कुर्वन्ति, वा अन्यम् उद्देष्टम् अपवञ्चयन्ति। + +एतेषु व्यक्तिषु निर्बन्धहीनता न स्थापय। द्रुततया तेषां व्यवहारं सार्वजनिकरूपेण उद्घोषयतु, शान्ततया च स्पष्टं कारणम् दत्त्वा त्रुटेः समाधानम् अनुबोधय। यदि समस्या अनवरतं वर्तते तर्हि तान् समुदायात् निष्कासयतु अथवा [आचारसंहिता अनुसारं](../code-of-conduct/#enforcing-your-code-of-conduct) उपयुक्तं कर्म कर्तु। + + + +नियन्त्रित-स्वल्पविवादाः प्रतिभावान् परिहर्तुं परियोजनस्य कार्ये बाधाः निर्माति। यदि नकारात्मक-व्यवहारं दर्श्यते तदा सार्वजनिकेकरूपेण तस्यावस्थां उल्लेखयित्वा सौम्ये एवं दृढे भाषायाम् कारणम् प्रकाशय। + +### योगदानकर्तॄणां अवस्थायाम् साक्षात्कारः + +समुदायस्य वृध्दौ दस्तावेजनस्य महत्त्वं पुनः प्रकाश्यते। अनियमित-योगदानकर्तारः सीघ्रतः संदर्भमार्गेण विषय-परिचयम् इच्छन्ति — तस्मात् CONTRIBUTING फाइल् मध्ये नवयोगदानकर्तॄणां आरम्भ-मार्गदर्शनं स्पष्टरूपेण स्थापयतु। + +हित-सूचक-लेबल् (e.g., "first timers only", "good first issue", "documentation") इत्यादि प्रयोगेण नवसदस्यान् शीघ्रं कार्ये निमन्त्रयतु। + +दस्तावेजने स्वागतकरं भाषणं प्रदर्शय। उदाहारणतया Rubinius परियोजनस्य CONTRIBUTING आरम्भेऽपि कृतज्ञतापूर्वकं अभिवादनं दत्तम् — एतदुक्त्वा नवयोगदानकर्तान् सक्रियतया आमन्त्रयति। + +### परियोजनस्य स्वामित्वं साझय {#share-ownership-of-your-project} + +संयुक्त-स्वामित्वे जनाः आत्मीयता अनुभवन्ति। एतत् न आवश्यकतया तव परियोजनस्य स्वप्नं पूर्णतया परिहरितुम्, परन्तु अन्येषां श्रेयस् दत्वा ते अधिकं स्थितिपूर्वकं भविष्यन्ति। + +एतेषु मार्गाः प्रायोगिकाः सन्ति: + +* **सुलभान् लघु-बग् समाधानान् स्वयं न कृत्वा नवयोगदानकर्तृणाम् प्रेरय।** +* **CONTRIBUTORS वा AUTHORS नामानि फाइल् स्थापय।** +* **समुदाये ब्लॉग् वा न्यूजलेटर् द्वारा कृतज्ञता व्यक्तयितु।** +* **सरल-योगदानकर्तृभ्यः commit-access दातु यदि तव परियोजनस्य संरचना अनुमन्यते।** +* **यदी परियोजनम् व्यक्तिगत-खातात् सङ्गठनात् योजय तर्हि backup-admins अपि योजय।** + +वास्तविकता इति यत् बहूनि परियोजनानि केवलं एके वा द्वौ परिचालकौ भवतः कर्म-भारं वहन्ति। जित्थु परियोजनस्य वृध्दिः, अन्यैः मदति द्वारा सहाय्य-साध्यते। प्रारम्भे संकेतं दत्त्वा सर्तकता वर्धय। + + + +## विवादस्य समाधानम् + +यदा परियोजनस्य आरम्भे महत्त्वपूर्ण-निर्णयाः सरलतया ज्ञाताः स्युः। किन्तु यदा परियोजनः प्रसिद्ध् भवति तदा बहवः जनाः तव निर्णयेषु अभिमतम् वदन्ति। + +रसतया यदि त्वया मित्रवत्, आदरयुक्तम् समुदायं विकसितं कृतम् अस्ति तथा प्रक्रियाः दस्तावेजिताः, तर्हि विवादाः सामान्यतया आत्म-समाधानम् लभन्ति। परन्तु कदाचित् क्लेशकराः विषया आगन्ति। + +### सौहार्दस्य मानदण्डम् स्थापय + +यदा विवादः गम्भीरः स्यात् तर्हि क्रोधितभावाः दृश्यन्ते; तदा तव कर्तव्यं अस्ति तदा परिस्थितिं संयमेन नियंत्रयितुम्। यदि त्वं विशेष मतं धारयसि तदा अपि मध्यस्थ-प्रवृत्तिं धारय। यदि कश्चन असौहार्दिकः वा वार्तां एकनिष्ठया स्वेच्छयति तर्हि शीघ्रतया कार्यवाही कुरु। + + + +अन्ये भवन्ति ये तव नेतृत्वं अपेक्षन्ति। किञ्चित् दुःखः, असन्तोषः वा चिन्ता व्यक्तु शक्यते; तथापि त्वम् संयततया प्रत्युत्तरं दत्त्वा स्वस्थ-समुदायं रक्षितुम् अर्हसि। + +### README-इव संविधानम् पाल्य + +तव README केवलं निर्देशे न भवेत्; तत्र तव लक्ष्याणि, परियोजना-दृष्टिः, तथा मार्गदर्शिका अपि प्रकाश्यन्ते। यदि कोऽपि विषयः विवादास्पदः भवति तर्हि README अवलोक्य तस्य दृढता चर्चां विमृशतु। + +### मार्गेण न लक्ष्ये चिन्तां कुरु + +मतदान-प्रक्रिया कदाचित् उत्तमा इति दृश्यते परन्तु मतदानं केवलं "उत्तरम्" प्राप्तुम् प्रेरयति न तु सम्वादं। मतदानं राजनैतिकं कर्तुं शक्यते। + +यदा परस्पर-अवकाशः नास्ति तदा "consensus-seeking" प्रक्रमः अधिकोयुक्तः भवति — सर्वेः पर्याप्तरूपेण श्रुताः इति सुनिश्चित्य प्रत्युत्तरं यावत् अल्प-पर्यन्तस्य चिन्तायाः शेषं तदा आगच्छेत्। + + + +यद्यपि त्वम् "consensus-seeking" न स्वीकरोषि, तदा अपि लोकाः श्रोतुं भवन्तु — श्रवणेन च कार्ये प्रगतिः। वचनैः च अनुवर्तनम् करणीयम्। + +### संवादः कर्मे केन्द्रितं भवतु + +चर्चा आवश्यकं परन्तु यदि चर्चा फलहीनं भवति तदा तत्र क्रियात्मकं मार्गनिर्देशं प्रदत्तुम् आवश्यकम्। यदि चर्चायां क्रियाणि न सन्ति तर्हि मुद्दाम् समापयित्वा स्पष्टीकर्तु यत् कियन्ति क्रमाः। + +यदि संवादः पतति अथवा न स्पष्टः तर्हि प्रश्नं कुर्व — "पुनरन्तरं कियानि क्रमाः?" इति। यदि स्पष्ट-कार्याः न सन्ति तर्हि इश्यू समाप्येत् तथा समापयितु कारणम् उद्घोष्यताम्। + + + +### युद्धं सुवर्णम् न स्पृश + +परिस्थितिः महत्वपूर्णा इति भवन्तु। चर्चायाम् कः सम्मिलितः अस्ति तथा तेषां प्रतिनिधित्वं किम् इति विचिन्तय। + +यदि चर्चायाः विषयः समुदायस्य समग्र-आवश्कतां न दर्शयति तर्हि केवलं संक्षेपे अन्यथा प्रश्नान् स्पष्टीकर्तुम् आवश्यकम्। यदि समस्या पुनरावृत्तिः अस्ति तर्हि पूर्व-चर्चासम्बद्धान् निर्देश्तुम्। + +### निर्णायकस्य चयनं कुरु + +किञ्चन् परिस्थितिषु मतभेदः अनिवार्यम्। तदा तव निर्णयकर्तुः (तटस्थ वा छोटा-समिति) यथोचितम् निर्दिश्येत्। साधारणतया तस्य निर्णयं तावत् अन्तिमः न भवति परं तस्य प्रक्रियायाः पूर्वनिर्देशः संचीयताम्। + +निर्णायकः केवलं अन्तिमोपायः भवेत्। विभेदाः समुदायाय शिक्षायाः अवसराः सन्ति — एतेषु समवेत-प्रक्रियया समाधानं योजयतु। + +## समुदायः मुक्तस्रोत्-हेतु हृदयं अस्ति + +स्वस्थः समुदायः मुक्तस्रोत् कार्यस्य हजारोऽनघान घण्टानां प्रेरकः अस्ति। बहवः योगदानकर्तारः अन्ये जनाः एव कारणं वदन्ति यतः ते कार्यं कुर्वन्ति — यदि त्वम् तस्य शक्तिम् सकारात्मकतया प्रयोगयेत् तर्हि कश्चन जनः अविस्मरणीयं मुक्तस्रोत् अनुभवम् अनभविष्यति। + +एवं कृत्वा परियोजनस्य स्वामित्वस्य साझकरणेन समुदायस्य विश्वासः च स्थायित्वं च प्राप्तुं शक्यते। diff --git a/_articles/sa/code-of-conduct.md b/_articles/sa/code-of-conduct.md new file mode 100644 index 00000000000..a21cdd1596f --- /dev/null +++ b/_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} + +यदा कदाचित् कश्चन आचारसंहितायाः उल्लङ्घनं कथयति तदा तस्य समाधानाय विभिन्नाः उपायाः सन्ति। + +### परिस्तिथि-विश्लेषणं कुर्व + +प्रत्येकस्य समुदायस्य सदस्यस्य वाच्यं महत्वपूर्णम् इव गृह्णीयात्। यदा कश्चन उल्लङ्घनस्य प्रतिवेदनं प्राप्तम्, तर्हि तत्र सम्यक् अनुसन्धानं करोतु। तेन समुदाये भवतः निर्णये विश्वासः वर्धते। + +### यथोचितं कर्म करोतु + +परिस्थितिः अवलोक्य यथोचितानि निर्णयानि गृह्यन्ते — सार्वजनिकतया चेत् सूचितं, निजतया चेत् समुपदेशनं, वा आवश्यकतया तात्कालिक-निषेधः। + +यदि विस्मरणीयम् वा पुनरावृत्तं व्यवहारः आसीत् तर्हि अधिकं प्रबलानि उपायाः (अल्पकालिक-प्रतिबन्धः, दीर्घकालिक-प्रतिबन्धः) अपि ग्रह्यन्ते। + +## परिचालकस्य उत्तरदायित्वम् + +आचारसंहिता केवलं कागदं न भवेत् — तस्य पालनम् सुनिश्चितं करणीयम्। परिचालकः आचारसंहितायाः नियमाः स्थापयति तथा तान् समाननियमेन साधयितुं उत्तरदायित्वं वहति। + +यदि प्रतिवेदनं यथा उल्लङ्घनम् न स्यात् इति निर्णेतुं तर्हि स्पष्टं प्रत्युत्तरं दत्त्वा कारणम् सूचयतु। + +## यत् वाञ्छसि तत् आचरणं प्रोत्साहयतु + +यदि परियोजना विरूपं वा नास्वीकृतं इति दृश्यते तर्हि योगदानकर्तॄणाम् दूर्यम् भवति। अतः स्वागतकरं वातावरणं स्थापयित्वा समुदायस्य वृद्ध्यर्थं प्रयत्नः कुर्यात्। + +--- diff --git a/_articles/sa/finding-users.md b/_articles/sa/finding-users.md new file mode 100644 index 00000000000..244508b2475 --- /dev/null +++ b/_articles/sa/finding-users.md @@ -0,0 +1,37 @@ +--- +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 वा सरलं डेमो पृष्ठं दत्तु। + +## समुदाय-संवादः आरभतु + +प्रचारं केवलं घोषणा न कुर्व — समुदायस्य समस्या समाधानाय मूल्यं प्रदातु। प्रश्नानां उत्तरम् दत्तु, सहयोगसूत्राणि प्रदर्शय, तथा योगदानकर्तॄणां स्वागतं कुरु। + +## ऑफलाइन क्रियाः + +स्थानीय-सम्मेलनानि, कार्यशालाः च परियोजनस्य दृश्यतां वर्धयन्ति। वक्तृत्वं वा डेमो प्रस्तुतीं दातु, लोकान् आकर्षयतु। + +## धैर्यं धारयतु + +परियोजनस्य प्रसारः कालेन भवति। नियमितानि प्रयत्नानि कुर्वन् सम्बन्धान् निर्मातुम् प्रयत्नः कुरु。 + diff --git a/_articles/sa/getting-paid.md b/_articles/sa/getting-paid.md new file mode 100644 index 00000000000..996ab3018d7 --- /dev/null +++ b/_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 इत्यादीनि माध्यमानि। +* **प्रायोजकता:** संस्थानैः वा व्यवसायैः सहयोगं लभित्वा प्रत्यक्षः अर्थसहाय्यः। +* **ग्रान्ट्:** अनुदान-निधयः परियोजनस्य विशिष्ट-कार्याणि समर्थयन्ति। +* **व्यवसायिक-समर्थनम्:** पेशेवर् सेवाः (कन्सल्टिंग्, प्रायोगिक-सपोर्ट्) वितरणेन आयः लभ्यते। + +## पारदर्शिता आवश्यकी + +यत् धनं समागतम् तस्य प्रयोगस्य स्पष्ट-लेखनी अनिवार्यं। खर्च-रिपोर्ट्, समर्थन-नीतिः च समुदायस्य विश्वासं रक्षति। + +## अपेक्षाः व्यवस्थापयतु + +यदि वित्तसमर्थनं स्वीकार्यते तर्हि योगदानकर्तॄणां अपेक्षाः स्पष्टतया लिखिताः भवन्तु — कोन कार्येषु धनं उपयुज्यते, तथा विज्ञापन-निर्देशाः वा व्यापारिक-संघटनस्य प्रभावः कथम् स्युः। + +एवं कुर्वन् वित्तलाभेन परियोजनस्य दायित्वं सुगमं कृत्वा दीर्घकालिकं कार्यं संरक्ष्यते। diff --git a/_articles/sa/how-to-contribute.md b/_articles/sa/how-to-contribute.md new file mode 100644 index 00000000000..5fbc3df2889 --- /dev/null +++ b/_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)। + +## समुदाय-सहयोगः + +सौजन्यं, धैर्यं च धृत्वा संवादं कुरु। यदि निर्देशाः अस्पष्टाः सन्ति तर्हि विनम्रतया पूरकप्रश्नान् पृच्छ। प्रविष्टिः न पश्यताम् चेत् सहकार्ये साधारण-कार्यं निर्दिश। + +## इव कार्यक्रमान् आयोजय + +स्थानीय-मिटीङ्ग् वा ऑनलाइन-कार्यशाला आयोज्य परियोजनस्य उपयोगित्वं विस्तरयतु। नवसदस्यान् आमन्त्रयतु तथा मार्गदर्शनं दातु। diff --git a/_articles/sa/index.html b/_articles/sa/index.html new file mode 100644 index 00000000000..d9ec2596177 --- /dev/null +++ b/_articles/sa/index.html @@ -0,0 +1,6 @@ +--- +layout: index +lang: sa +title: मुक्तस्रोत मार्गदर्शिका +permalink: /sa/ +--- diff --git a/_articles/sa/leadership-and-governance.md b/_articles/sa/leadership-and-governance.md new file mode 100644 index 00000000000..c81da23e162 --- /dev/null +++ b/_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)** + +परिचालकः कदाचित् केवलं कोड् लेखकः न भवेत्; सः परियोजनस्य प्रचारकः, दस्तावेज-लेखकः च भूत्वा परियोजनस्य दिशा-भावे उत्तरदायित्वं वहति। + +योगदानकर्तृ इति सर्वः स्यात् यस्य यथाकिञ्चन योगदानं भवति — इश्यू-ट्रायजिङ्, कोड्, वा कार्यक्रम-आयोजनम् अपि। + +एवमेव पारदर्शिता, भूमिकानाम् स्पष्टता च समुदायस्य दीर्घस्थायित्वाय आवश्यकम्। diff --git a/_articles/sa/legal.md b/_articles/sa/legal.md new file mode 100644 index 00000000000..757a06a610f --- /dev/null +++ b/_articles/sa/legal.md @@ -0,0 +1,33 @@ +--- +lang: sa +title: "मुक्तस्रोत् विधिक-पक्षः" +description: "मुक्तस्रोत् सम्बन्धि विधिक-आवश्यकताः सरलरूपेण अवगन्तव्या:" +class: legal +order: 10 +image: /assets/images/cards/legal.png +related: + - contribute + - leadership +--- + +## विधिक-संदर्भस्य संक्षेपः + +यदा भवन्तः स्वस्य सर्जनात्मक-कृतिं विश्वे प्रकाशयन्ति, तदा तस्य कर्तव्येषु किञ्चन विधिक-प्रश्नाः भवन्ति। सामान्यतः मौलिककृतिः अधिकार-नियन्त्रणेन रक्षितः अस्ति; अतः इतराः स्वेच्छया तस्य उपयोगं, प्रतिलिपिं वा पर्यवस्थापनं न कुर्युः। + +मुक्तस्रोत् परिप्रेक्ष्ये, कर्ता इतरान् तेन उपयोगितुं इच्छति — तेन कारणेन लायसेंस् (license) निर्दिष्टुं आवश्यकम् यत् इतरैः स्पष्ट अधिकाराः प्रदातुं शक्यन्ते। + +## योगदानस्य अधिकारः + +यदि परियोजनायाः पास् लायसेंस् नास्ति तर्हि योगदानानि तेषां लेखकानां स्वाम्येनाधीनानि भवन्ति; अतः तानि उपयोगितुं इतरैः स्पष्ट-सहमति आवश्यकम्। + +## गीथब् सार्वजनिकः कृतः इति तत्तु लायसेंस् न भवति + +गीथब् मध्ये रिपोजिटरी सार्वजनिकं कृतम् इति लायसेंस्-प्रदानं न भूयात्। सार्वजनिकता केवलं दर्शयति, परंतु अनुमति-प्रदानं न करóति। इति कारणेन, यद् भवतः परियोजनं इतरैः उपयोगितुं इच्छसि तर्हि सम्यक् मुक्तलायसेंस् स्थापितुं युक्तम्। + +## शीघ्र-निर्णयानि (TL;DR) + +* सामान्य-लायसेंसाः: MIT, Apache 2.0, GPLv3 इत्यादयः प्रचलिताः। +* लायसेंस्-निर्धारणेन परियोजना उपयोगस्य शर्ताः स्पष्टाः भवन्ति। +* नव-परियोजनस्य आरम्भे लायसेंस् स्थापयितु शुश्रुषा उत्तमा। + +यदि आवश्यकं, विधिक-सलाहकारेण परिशीलनं अपि कर्तव्यम्। diff --git a/_articles/sa/maintaining-balance-for-open-source-maintainers.md b/_articles/sa/maintaining-balance-for-open-source-maintainers.md new file mode 100644 index 00000000000..258091362ad --- /dev/null +++ b/_articles/sa/maintaining-balance-for-open-source-maintainers.md @@ -0,0 +1,36 @@ +--- +lang: sa +title: "परिचालकानां विवेक-समत्वं (Balance)" +description: "परिचालयते चेत् स्वयं-परिचर्या तथा दीर्घकालिक-उत्साहस्य रक्षणस्य परिचते उपायाः।" +class: balance +order: 0 +image: /assets/images/cards/maintaining-balance-for-open-source-maintainers.png +--- + +## परिचयः + +परियोजनेऽधिगतः समयः यदि दीर्घकालिकः स्यात् तर्हि परिचालकस्य दीर्घजीवित्वाय स्व-परिचर्यायाः व्यवस्था अनिवार्या वर्तते। स्वस्य ऊर्जा-समतुल्यं रक्ष्यन्ते चेत् उत्तमं कार्यं दीर्घकालं कर्तुं शक्यते। + +## व्यक्तिगत् पारिस्थितिकी (Personal ecology) + +एषा संकल्पना सार्थकं वृत्तान्तं देयते — व्यक्तिगतः आहारः, विश्रामः, कार्य-गुच्छः च इत्यत्र विचार्यन्ते। एतस्य अभ्युक्रियया परिचालकाः तत् निवारयन्ति यत् क्लेशः कालक्रमेण समुदायस्य प्रति प्रतिकूलः न भवेत्। + +## स्व-परिचर्यायाः सल्लाहाः + +* **प्रेरणारूपाणि लक्ष्याणि ज्ञातव्यानी:** किम् भवतः प्रेरकं? उपयोगकर्तृप्रशंशा, सहयोगेन आनन्दः वा क्रियातः सन्तोषः — एतानि बोधेन कार्यानुक्रमः निर्णीतः। +* **सीमासूचकानि स्थापयतु:** कार्य-घण्टाः अथवा सप्ताहिक-प्रतिबद्धताः लिखित्वा स्पष्टतां धारयतु। +* **अवकाशं गृहाण:** विश्राम-सत्राणि नियोज्य मनः-शक्ति रक्ष्यताम्। +* **कार्यवितरणं कुर्व:** अन्यैः कार्यभारं विभज्य स्वयं-भारं न्यूनं कुरु। +* **सहाय्यं माँगतु:** यदि क्लेशः वर्धते तर्हि समुदाये अथवा विश्वासी सहकरेशु मार्गदर्शनं सन्दधातु। + +## क्लेशेण संघर्षः कान् लक्षाणि + +क्लेशः तावत् ज्ञातः स्यात् यदा प्रेरणा नश्यति, ध्यान-क्षमता न्यूनं भवति, अथवा समुदायस्य प्रति सहानुभूत्याः अभावः दृश्यते। एते लक्षणानि शीघ्रं मन्यन्ताम् तथा तेषां कारणान् विशदीकर्तुम् प्रयत्नः कुर्यात्। + +## परियोजनायाः समर्थनम् + +परिचालकानां अनुभवस्य वार्तालापेन सहकारी-कार्यशाला समायोज्येत् इति लाभदायकम्। सामूहिक-अभ्यासैः उत्तमान् उपायान् अन्वेष्टुं शक्यते। + +## उपसंहारः + +परिचालकस्य दीर्घजीवित्वं परियोजनस्य हिताय अनिवार्यं अस्ति। व्यक्तिगत् समत्वं रक्ष्येत् तर्हि समुदायः अपि समृद्धः भविष्यति। diff --git a/_articles/sa/metrics.md b/_articles/sa/metrics.md new file mode 100644 index 00000000000..07353c11103 --- /dev/null +++ b/_articles/sa/metrics.md @@ -0,0 +1,34 @@ +--- +lang: sa +title: "मापकानि — परियोजनस्य क्रियाशीलता-अन्वेषणम्" +description: "परियोजनस्य सफलतायाः निर्णयेषु साहाय्याय परिमाणनं तथा अनुवर्तनं कुर्वन्तु।" +class: metrics +order: 9 +image: /assets/images/cards/metrics.png +related: + - finding + - best-practices +--- + +## किमर्थं मापनं आवश्यकम् + +दत्तानि यदि सम्यक् प्रकारेण प्रयोगेक्रियन्ते, तर्हि ते विकल्पान् सज्जीकर्तुं सहायतां ददन्ति। मापन-डेटा परियोजनस्य उपयोगकर्तृ व्यवहारं, लोकप्रियतां च सूचयितुं शक्नोति। + +## किम् मापयेत् + +* नयाँ विशेषतायाः प्रतिसादः +* नव-उपयोगकर्तृभ्यः आगमन-स्रोतः +* असाधारण-प्रयोग-प्रकरणानि यथापि समर्थनशीलानि वा न इति निर्णयः +* परियोजनस्य लोकप्रियता परिमाणीकरणं + +## कुतः आरभेत् + +यदा तव परियोजनस्य गतिविधिः ज्ञाता तदा त्वं उत्तमा-निर्णयानि ग्राहयितुं शक्नोषि — कत् कार्यं प्रथमं, कः सुधारः अधिक प्रभावी, कुत्र विज्ञापनं कुर्वीत इति। + +## साधनानि + +GitHub Insights, Google Analytics, तथा repository-विश्लेषण उपकरणानि उपयोगयतु। ईतानि उपकरणानि परियोजनस्य ट्राफिक्, रेफरर्-श्रेणी, तथा उपयोगकर्तृ-व्यवहारम् दर्शयन्ति। + +## निष्कर्षः + +मापनस्य परिणामान् बुद्धिपूर्वकं उपयोग्य परियोजनस्य दीर्घजीवित्वाय समुचित निर्णयान् गृह्यन्तु。 diff --git a/_articles/sa/security-best-practices-for-your-project.md b/_articles/sa/security-best-practices-for-your-project.md new file mode 100644 index 00000000000..e39de5bddb6 --- /dev/null +++ b/_articles/sa/security-best-practices-for-your-project.md @@ -0,0 +1,38 @@ +--- +lang: sa +title: "परियोजनस्य सुरक्षा-उत्तमाः पद्धतयः" +description: "MFA, कोड्-स्कैनिङ्, निर्भरता-नियमनं च — परियोजनस्य सुरक्षा-आधारः दृढीकुर्यात्।" +class: security-best-practices +order: -1 +image: /assets/images/cards/security-best-practices.png + +--- + +## परिचयः + +परियोजनस्य दीर्घजीवित्वं केवलं उपयोगित्वे न, परं उपयोगकर्तृभ्यः प्राप्त-विश्वासे अपि निहितम् अस्ति। सुरक्षा-उपायाः तं विश्वासं संरक्षयितुं अनिवार्याः। अधः किञ्चित् प्रमुख-उपायाः दत्ताः सन्ति। + +## सर्वे विशेषाधिकारिणः MFA उद्घाटयन्तु + +विशेषाधिकारयुक्त-खातुश्च सम्यक् अभिगमनस्य रक्षणार्थं द्वि-घटक प्रमाणीकरणम् (MFA) अनिवार्यम् अस्ति। यदि दुष्टसक्तिः विशेषाधिकारिणम् अभिकल्प्यते तर्हि तीव्रहानिः सम्भवति — कोड् परिवर्तनं, दुर्भावनापूर्ण-सॉफ्टवेअर् वितरणं, वा संवेदनशील-दत्तानाम् अपहरणम्। + +## विकासप्रवाहे सुरक्षा समावयतु + +सुरक्षा-कमी वर्त्तन्ते चेत् ते शीघ्रं ज्ञातानि स्यात् तर्हि मर्यादितव्ययेन सा सुधारिता भवति। SAST (Static Application Security Testing) उपकरणानि कोड् स्तरस्य दोषान् विशृण्वन्ति तथा CI प्रक्रियायाम् एकीक्रियन्ते। इदं कोड्-समिक्षा प्रक्रियायाम् उपयुक्तम्, यतः पूर्वावस्थायाम् दोषान् प्रथमतया दृष्ट्वा समाकुर्यात्। + +## गोपनीय-सूचनाः न स्थापयन्तु + +API-कुञ्जिका, टोकन, पास्वर्ड् च रिपोजिटरीमध्ये अनायासेन न योजयन्तु। "Secret scanning" साधनानि उपयुज्य दत्तानि प्रतिबन्धनीयानि भवेत्। GitHub Secret Scanning, TruffleHog इत्यानि उपकरणानि एतेषु सहाय्यं कुर्वन्ति। + +## निर्भरतानां निरीक्षणम् + +निर्भरतासु दोषाः तव परियोजनस्य सुरक्षा-जोखिमं वर्धयन्ति। Dependabot, Renovate च इवैव SCA उपकरणानि ज्ञात-सीक्युरिटी-घटनान् रिपोर्टयन्ति तथा सुरक्षित-संस्करणेषु अद्यतनार्थं PRs रचयन्ति। + +## संरक्षण-शाखाः (Protected branches) + +मुख्य-शाखासु अप्रतिबन्धित् लेखनं अनिष्ट-परिणामान् जन्मयितुम् शक्नोति। शाखा-रक्षण-नियमाः परीक्षणसफलतां, समीक्षां च आवश्यकताम् आरोपयन्ति, यतः मुख्यशाखायाः स्थिरता रक्ष्यते। + +## भेद्यतापत्र-सूचना तन्त्रं स्थापयतु + +संवेदनशील-दोषानां गोपनीय-रिपोर्टिङ् मार्गः स्थापनीयः, यतः शोधकाः सुरक्षितविधिना दोषान् सूचयन्तु। नियमाः स्पष्टाः च प्रतिपादनं कृत्वा, त्वं शीघ्रं प्रति-कृत्यं गृह्णास्यः। + diff --git a/_articles/sa/starting-a-project.md b/_articles/sa/starting-a-project.md new file mode 100644 index 00000000000..01eab368068 --- /dev/null +++ b/_articles/sa/starting-a-project.md @@ -0,0 +1,37 @@ +--- +lang: sa +title: "परियोजनारम्भः" +description: "मुक्तस्रोत परियोजनम् आरम्भाय लघु मार्गदर्शिका — समस्या चिन्व, सहकर्मिणः चयनय, उपयोगाय योग्यं किञ्च प्रकाशितु।" +class: starting +order: 2 +image: /assets/images/cards/starting-a-project.png +related: + - best-practices + - building +--- + +## किमर्थं परियोजनम् आरभेतुम्? + +किं कारणेन भवतः परियोजनम् आरभेतुम्? कदाचित् भवतः दृष्टे कश्चन समस्या अस्ति यत् अन्येऽपि समाधानं न दत्तवन्तः; कदाचित् स्वकिञ्चित् अनुशोभनार्थं वा अभ्यासार्थं परियोजनं आरभेतुम् इच्छसि; अथवा तव कार्यस्य प्रदर्शनेषु कोऽपि सन्दर्भार्थं किञ्च निर्माणं कर्तुम् इच्छसि। यत् कारणं भवेत्, परियोजनारम्भः ज्ञानं लभितुं च समुदायस्य योगदानं पालयितुं सुखप्रदः मार्गः अस्ति। + +## त्वया चिन्तनीया समस्या चिन्व + +यदि त्वं समस्यायाः विषये चित्तं न दास्यसि तर्हि अन्येऽपि न दास्यन्ति। तस्यर्थम् त्वया रोचकं वा उपयोगकरं इति मन्यते तादृशं समस्या चिन्व। उत्तमानि परियोजनानि ते सन्ति यानि तन्मध्ये लेखकस्य वा उपयोगकर्तारः कृत्येषु साहाय्यं कुर्वन्ति। + +## लघु तथा केन्द्रितं रक्षतु + +लघु-क्षेत्रे लक्षितं परियोजनं आरभ्य तस्य सफलस्य सम्भावना वर्धते। न्यूनतमं कार्यक्षमं रूपम् (MVP) निर्माता चानन्तरम् प्रवर्तय; तेन शीघ्रं उपयोगकर्तॄणां च योगदानकर्तॄणां आगमनं सम्भवति। स्पष्टं सीमितं लक्ष्यं स्थापयितुं प्रयत्नं कुरु। + +## सहकर्मिणः अन्वेषयतु + +मुक्तस्रोतपरियोजनाः सामान्यतया अन्यानां सहयोगेन वृध्दिं याति। प्रारम्भिककार्ये मित्राणाम् वा सहकर्मिणाम् पृच्छतु यत् सहायतां दास्यन्ति। प्रारम्भिकयोगदानकर्तारः दस्तावेजनम्, परीक्षणम्, प्रचारः च कर्तुं शक्नुवन्ति। + +## यत् लोकैः उपयोग्यं भवति तत् प्रकाशयतु + +मूल्यं प्रदातुम् केन्द्रं कुर्व। यदि भवतः परियोजनं कस्यापि कर्म कृत्वा सुलभतया सिद्ध्यति अथवा कश्चन समस्या निराकुर्यात्, तर्हि उपयोगकर्तृभः तं अनुकरणीयं मन्यन्ते। परियोजनस्य स्पष्टं दस्तावेजनं दत्तव्यम्, उदाहरणानि प्रदातव्यानि, आरम्भस्य मार्गदर्शिका च सुकरं कृत्वा प्रदातव्या। + +## नित्यम् संवर्धय + +प्रतिक्रिया सङ्ग्रहय, पुनरावृत्तिं कुर्व, च उपयोगकर्तॄणां अपेक्षायाम् प्रत्युत्तरं दातुं सज्जः भव। व्यावहारिकपद्धत्या सानुकूल्यं कृत्वा नियमितं सुधाराः प्रकाशयेत् यत् परियोजनस्य ग्रহণशीलता वर्धयति। + +यदि इच्छसि, अन्यानि `sa` लेखान् अहं अपि संस्कृते अनुवादितुं आरभेयं। diff --git a/_includes/nav.html b/_includes/nav.html index 5a63da061fb..80131cc4e63 100644 --- a/_includes/nav.html +++ b/_includes/nav.html @@ -37,8 +37,12 @@ {% if page.layout != 'index' %}

- {% if page.lang != 'en' %} - {{ site.title }} + {% assign lang_url = '/' | append: page.lang | append: '/' %} + {% assign lang_index = site.pages | where: "url", lang_url %} + {% if page.lang != 'en' and lang_index.size > 0 %} + {{ site.title }} + {% elsif page.lang != 'en' %} + {{ site.title }} {% else %} {{ site.title }} {% endif %} diff --git a/_layouts/article.html b/_layouts/article.html index cd5f8c4c06a..ce6e46dc288 100644 --- a/_layouts/article.html +++ b/_layouts/article.html @@ -23,7 +23,8 @@

{{ page.title }}

- {{ page.title }} + {% assign illo = page.class | default: 'default' %} + {{ page.title }}
@@ -49,7 +50,8 @@

{{ t.article.related_guides }}

- {{ article.title }} illustration
diff --git a/_layouts/index.html b/_layouts/index.html index f3df799eb29..71bb45ca54a 100644 --- a/_layouts/index.html +++ b/_layouts/index.html @@ -33,7 +33,8 @@

{{ header }}
- {{ article.title }} illustration
diff --git a/assets/images/illos/default.svg b/assets/images/illos/default.svg new file mode 100644 index 00000000000..2bac94c5fcb --- /dev/null +++ b/assets/images/illos/default.svg @@ -0,0 +1,7 @@ + + + + + + + \ No newline at end of file diff --git a/assets/images/illos/starting.svg b/assets/images/illos/starting.svg new file mode 100644 index 00000000000..6d72d0ca284 --- /dev/null +++ b/assets/images/illos/starting.svg @@ -0,0 +1,8 @@ + + + + + + starting + +