साल 2022 की केस स्टडी रिपोर्ट

मौजूदा फ़ेज़:
केस स्टडी पब्लिश की गई हैं. टाइमलाइन देखें.

ध्यान दें: इस रिपोर्ट में, प्रोग्राम के मूल आवेदनों और संगठनों की फ़ाइनल केस स्टडी का डेटा शामिल होता है. पूरी केस स्टडी, Season of Docs 2022 के नतीजों वाले पेज से लिंक की गई हैं.

Season of Docs, एक ऐसा प्रोग्राम है जिसका मकसद पर्यावरण को बनाए रखना है. इसे Google Open Source Programs Office मैनेज करता है. Season of Docs के लक्ष्य ये हैं:

• दस्तावेज़ों की मदद से, प्रोजेक्ट की समस्याओं को हल करने के लिए, ओपन सोर्स प्रोजेक्ट के लिए सहायता देना
• तकनीकी लेखकों को ओपन सोर्स में अनुभव पाने के अवसर दें
• ओपन सोर्स, दस्तावेज़, और तकनीकी लेखन के बारे में जागरूकता बढ़ाना
• ओपन सोर्स दस्तावेज़ों में असरदार मेट्रिक के बारे में जानकारी इकट्ठा करना और शेयर करना

'दस्तावेज़ों का सीज़न' के बारे में ज़्यादा जानकारी, इस कार्यक्रम की वेबसाइट पर उपलब्ध है.

साल 2022 के प्रोग्राम की खास जानकारी

Season of Docs के काम करने का तरीका

सीज़न ऑफ़ डॉक्स में, संगठन प्रोजेक्ट का प्रस्ताव सबमिट करके आवेदन करते हैं. प्रोजेक्ट के प्रस्ताव में ये शामिल हैं:

• संगठन के बारे में जानकारी
• प्रोजेक्ट में आ रही समस्या के बारे में जानकारी
• समस्या को हल करने के लिए, प्रोजेक्ट में दस्तावेज़ों का इस्तेमाल कैसे किया जाएगा
• प्रोजेक्ट अपने दस्तावेज़ों (मेट्रिक) के असर का आकलन कैसे करेगा
• काम की टाइमलाइन
• प्रोजेक्ट का बजट
• कोई अन्य जानकारी, जैसे कि मिलते-जुलते प्रोग्राम में संगठन का अनुभव या कोई ऐसी जानकारी जिससे Season of Docs के एडमिन को अपने प्रोजेक्ट और समस्या को समझने में मदद मिल सके

इस कार्यक्रम में शामिल होने के बाद, संगठन सीधे तौर पर अपने तकनीकी लेखकों को भर्ती करते हैं और उन्हें नौकरी देते हैं. Season of Docs, संगठनों को फ़ंड देने के लिए Open Collective का इस्तेमाल करता है. साथ ही, संगठन Open Collective के ज़रिए तकनीकी लेखकों को पेमेंट करते हैं. प्रोजेक्ट के बजट और पेमेंट साफ़ तौर पर दिखते हैं. बजट, Season of Docs की साइट पर उपलब्ध संगठन के प्रोजेक्ट के प्रस्तावों में शामिल होते हैं. साथ ही, पेमेंट Season of Docs के Open Collective खाते में दिखते हैं.

जब संगठन अपनी केस स्टडी रिपोर्ट सबमिट कर देते हैं, तब माना जाता है कि उन्होंने प्रोग्राम पूरा कर लिया है. संगठनों को कार्यक्रम के दौरान हर महीने आकलन करने के लिए भी कहा जाता है. साथ ही, कार्यक्रम पूरा होने के बाद एक साल के दौरान हर तिमाही तीन फ़ॉलो अप सर्वे भी करने होते हैं.

साल 2022 की हाइलाइट

“नया दस्तावेज़ रिलीज़ होने के बाद, Casbin और Casdoor पर हर दिन आने वाले लोगों की संख्या करीब दोगुनी हो गई. साथ ही, बाउंस रेट में करीब 30% की गिरावट आई.”—Casbin

“इस प्रोजेक्ट की वजह से, [हमारे तकनीकी लेखकों] को हमारी कम्यूनिटी में लीडरशिप की भूमिकाएं मिल रही हैं. अब ये दोनों योगदान देने वाले लोग, वर्किंग ग्रुप और कम्यूनिटी मीटिंग की अगुवाई कर रहे हैं. साथ ही, हमारे प्रोजेक्ट के डिज़ाइन और रखरखाव में भी योगदान दे रहे हैं.” —moja-global

“[GSoD] की मदद से, हमने दो प्रतिभाशाली तकनीकी लेखकों को भर्ती किया. आम तौर पर, ऐसा करना बहुत मुश्किल होता है. ये दोनों OpenMined के लिए, ओएस के लिए लगातार योगदान देते रहे हैं. साथ ही, इनके साथ काम करने का हमारा अनुभव बहुत अच्छा रहा है.” —OpenMined

“इसके अलावा, नया मैन्युअल, कंप्यूटेशनल मास स्पेक्ट्रोमेट्री के लिए नए लोगों के लिए काफ़ी आसान है. इस बात को समझाने के लिए: CZI का अनुदान, ऐतिहासिक तौर पर वंचित लोगों को भी स्टाइपेंड देता है. कुछ लोगों ने छह हफ़्ते की इंटर्नशिप शुरू करने के लिए, OpenMS के नए मैन्युअल का इस्तेमाल किया है और उन्होंने नए मैन्युअल की सकारात्मक समीक्षाएं की हैं.” —OpenMS

साल 2022 का खास जानकारी वाला डेटा

साल 2022 में, सीज़न ऑफ़ द डॉक्स प्रोग्राम में 67 आवेदनों में से 31 प्रोजेक्ट स्वीकार किए गए. इनमें से 30 प्रोजेक्ट ने प्रोग्राम पूरा किया. स्वीकार किए गए 31 संगठनों में से 17 संगठन, पहले भी आवेदन कर चुके थे.

स्वीकार किए गए 31 प्रोजेक्ट के लिए, 58 तकनीकी लेखकों को काम पर रखा गया. 190 से ज़्यादा तकनीकी लेखकों ने इस कार्यक्रम में हिस्सा लेने की दिलचस्पी दिखाई है. इसके लिए, उन्होंने Season of Docs के GitHub रिपॉज़िटरी में अपनी संपर्क जानकारी और अपने पोर्टफ़ोलियो के लिंक जोड़े हैं.

साल 2022 के प्रोग्राम के लिए:

• आवेदन करने की प्रोसेस से 100% संगठनों का अनुभव अच्छा रहा
• 100% संगठनों को कार्यक्रम की वेबसाइट के दस्तावेज़/कॉन्टेंट से अच्छा अनुभव मिला
• 93% संगठनों को इस प्रोग्राम से फ़ायदा हुआ
• 90% संगठनों को लगा कि दस्तावेज़ बनाने का उनका प्रोजेक्ट सफल रहा

संगठनों के बारे में जानकारी

सीज़न ऑफ़ द डॉक्स 2022 में हिस्सा लेने वाले संगठनों ने अलग-अलग तरह के ओपन सोर्स प्रोजेक्ट दिखाए. साल 2022 के कोहॉर्ट में ये शामिल थे:

• डेवलपमेंट टूल, जैसे कि AsyncAPI और SpyderIDE
• प्रोग्रामिंग भाषाएं और फ़्रेमवर्क, जैसे कि Julia, LFortran, R, और p5.js
• वैज्ञानिक प्रोजेक्ट, जैसे कि CERN-HSF और SymPy
• असली उपयोगकर्ता के लिए बने ऐप्लिकेशन, जैसे कि Mautic, Open Food Facts, Talawa, और Ushahidi
• हार्डवेयर और रोबोटिक्स प्रोजेक्ट, जैसे कि ExpressLRS और Open-RMF
• डेटा प्रोजेक्ट, जैसे कि GeomScale, GeomStats, OpenMined, और Weaviate
• क्लाउड और इन्फ़्रास्ट्रक्चर प्रोजेक्ट, जैसे कि cert-manager, NimbleEdge, और Cilium

हमने प्रोजेक्ट के बारे में कोई मेटाडेटा इकट्ठा नहीं किया है. जैसे, प्रोजेक्ट बनाने की तारीख, योगदान देने वाले लोगों की जगह की जानकारी, योगदान देने वाले लोगों की संख्या या उपयोगकर्ताओं की संख्या.

हमने प्रोजेक्ट से यह बताने के लिए कहा था कि उन्होंने किस ओपन सोर्स लाइसेंस का इस्तेमाल किया है.

दस्तावेज़ से जुड़े प्रोजेक्ट के बारे में जानकारी

दस्तावेज़ से जुड़ी समस्याएं

साल 2022 के कार्यक्रम में दस्तावेज़ों की मदद से, संगठनों को इन समस्याओं को हल करने की उम्मीद थी:

ध्यान दें कि संगठन, दस्तावेज़ से जुड़ी कई समस्याओं की शिकायत कर सकते हैं. ज़्यादा जानकारी के लिए, सीज़न ऑफ़ द डॉक्स 2022 का नतीजों का पेज देखें. इस पेज पर, हर संगठन के लिए प्रोजेक्ट के मूल प्रस्ताव और पूरी केस स्टडी का लिंक मौजूद है.

बनाए गए दस्तावेज़ों के टाइप

साल 2022 की केस स्टडी में, 'कैसे करें' दस्तावेज़ों का सबसे ज़्यादा इस्तेमाल किया गया.

केस स्टडी में बताए गए अन्य दस्तावेज़ों में ये शामिल हैं:

• क्विकस्टार्ट
• शब्दावली
• अक्सर पूछे जाने वाले सवाल
• नॉलेजबेस
• घटक
• ब्लॉग/सोशल मीडिया कॉन्टेंट
• डेवलपर के लिए गाइड

इनमें से कुछ कैटगरी फ़ज़ी होती हैं. साथ ही, किसी दस्तावेज़ प्रोजेक्ट में कई तरह के दस्तावेज़ या सुविधाएं हो सकती हैं.

ज़्यादा जानकारी के लिए, सीज़न ऑफ़ द डॉक्स 2022 का नतीजों का पेज देखें. इस पेज पर, हर संगठन के लिए प्रोजेक्ट के मूल प्रस्ताव और पूरी केस स्टडी का लिंक मौजूद है.

बजट मैनेज करना

बजट के लिए किए गए अनुरोध की औसत रकम 11,679 डॉलर थी और मीडियन 12,150 डॉलर था. पांच संगठनों ने सबसे ज़्यादा अनुदान (15 हज़ार डॉलर) का अनुरोध किया और उन्हें यह अनुदान भी मिला. वहीं, तीन संगठनों ने सबसे कम अनुदान (5 हज़ार से 7 हज़ार डॉलर) का अनुरोध किया और उन्हें यह अनुदान भी मिला.

सक्रिय उपयोगकर्ताओं से जुड़ी मेट्रिक

उनकी केस स्टडी में बताए गए प्रोजेक्ट, जिन मेट्रिक का इस्तेमाल करके वे अपने दस्तावेज़ बनाने वाले प्रोजेक्ट की सफलता का आकलन कर रहे थे.

सुझाई गई मुख्य मेट्रिक ये थीं:

सुझाई गई अन्य मेट्रिक में ये शामिल हैं:

• दस्तावेज़ से जुड़े ज़्यादा पुश अनुरोध/योगदान
• दस्तावेज़ों के पेजों पर सीधे तौर पर सुझाव, शिकायत या राय देना
• पेज पर बिताया गया समय
• उठाई गई समस्याएं (इस्तेमाल के लिए प्रॉक्सी के तौर पर)
• फ़ोरम में हिस्सा लेने वाले लोग
• पार्टनर/वॉलंटियर/इंटिग्रेशन की संख्या
• बाउंस रेट में कमी
• कम्यूनिटी में जागरूकता बढ़ती है.

तकनीकी लेखन के प्रोजेक्ट पूरे करने और केस स्टडी सबमिट करने के बीच कम समय होने की वजह से, 2022 के ज़्यादातर कोहॉर्ट ने केस स्टडी सबमिट करते समय ज़रूरत के मुताबिक डेटा इकट्ठा नहीं किया था. इससे यह पता नहीं चल पाया था कि उनकी शुरुआती मेट्रिक पूरी हुई हैं या नहीं.

साल 2023 में, फ़ॉलोअप सर्वे के जवाब मिलने के बाद, हम इस रिपोर्ट को अपडेट करेंगे. इसमें यह जानकारी जोड़ी जाएगी कि किन प्रोजेक्ट ने अपनी मेट्रिक हासिल की हैं या अपनी मेट्रिक में बदलाव किया है.

ज़्यादा जानकारी के लिए, सीज़न ऑफ़ द डॉक्स 2022 का नतीजों का पेज देखें. इस पेज पर, हर संगठन के लिए प्रोजेक्ट के मूल प्रस्ताव और पूरी केस स्टडी का लिंक मौजूद है.

तकनीकी लेखकों के साथ काम करना

'Docs का सीज़न' प्रोग्राम में, प्रोजेक्ट को तकनीकी लेखकों को सीधे तौर पर भर्ती करना, इंटरव्यू लेना, उन्हें नौकरी देना, और उन्हें पैसे देना चाहिए. तकनीकी लेखक, GitHub रिपॉज़िटरी में मौजूद, Season of Docs की डायरेक्ट्री में खुद को जोड़ सकते हैं. हालांकि, Season of Docs का स्टाफ़, तकनीकी लेखकों की जांच नहीं करता या उनके सुझाव नहीं देता.

ओपन सोर्स प्रोजेक्ट के लिए तकनीकी लेखकों को हायर करने के सबसे सही तरीके

प्रोजेक्ट से कहा गया था कि वे तकनीकी लेखकों को भर्ती करने, उन्हें नौकरी देने, और उनके साथ काम करने के सबसे सही तरीके शेयर करें. सबसे ज़्यादा सुझाए गए वीडियो ये थे:

नियुक्ति

• सीवी की समीक्षा करने के बजाय, कम उम्मीदवारों का इंटरव्यू लें और लाइव प्रैक्टिस सेशन का इस्तेमाल करें
• अपने प्रोजेक्ट की भाषा या टूल के इस्तेमाल की जानकारी के बजाय, लिखने और बोलने की स्किल को अहमियत दें
• सीधे सवाल पूछें कि तकनीकी लेखक आपके प्रोजेक्ट के साथ काम करने के लिए, डोमेन की ज़रूरी जानकारी कैसे हासिल करेगा
• अगर कोई व्यक्ति आपके प्रोजेक्ट के मिशन में दिलचस्पी रखता है और ओपन सोर्स की मुख्य वैल्यू शेयर करता है, तो पूरे प्रोजेक्ट के दौरान उसके उत्साहित बने रहने की संभावना ज़्यादा होती है
• दुनिया भर के लोगों को आवेदन करने की अनुमति दें, क्योंकि अलग-अलग नज़रियों और बैकग्राउंड वाले लोगों की मदद से आपके प्रोजेक्ट को बेहतर बनाया जा सकता है. हालांकि, ध्यान रखें कि अलग-अलग टाइम ज़ोन में रहने वाले लेखकों और मेंटर के साथ अच्छा कम्यूनिकेशन बनाए रखने के लिए, ज़्यादा मेहनत करनी पड़ सकती है

नौकरी के लिए भर्ती

• ऐसे कानूनी समझौते का इस्तेमाल करें जिसमें डिलीवर किए जाने वाले आइटम, पेमेंट के शेड्यूल, और समय से जुड़ी खास बातें साफ़ तौर पर बताई गई हों
• अगर आपके प्रोजेक्ट के बारे में बहुत कुछ पता नहीं है, तो दस्तावेज़ बनाने के अलावा, खोज या रिसर्च के लिए एक माइलस्टोन शामिल करें

कोऑर्डिनेशन और कम्यूनिकेशन

• मीटिंग में लिए गए फ़ैसलों को रिकॉर्ड करने के लिए, मीटिंग लॉग बनाएं. इससे प्रोजेक्ट पर काम करने वाले सभी लोगों को संदर्भ और अगले चरणों को समझने में आसानी होगी
• यह साफ़ तौर पर बताएं कि आपको किस तरह की जानकारी कितनी बार चाहिए. जैसे, हर हफ़्ते कॉल, हर दिन ईमेल या चैट चैनल पर स्टेटस अपडेट
• जवाब दें और साफ़ तौर पर सुझाव/राय दें. इसमें सिर्फ़ 'क्या' नहीं, बल्कि 'क्यों' भी शामिल होना चाहिए
• तकनीकी लेखकों को बड़ी कम्यूनिटी से जोड़ें, ताकि उन्हें संदर्भ दिया जा सके और उनके काम को सोशल मीडिया पर शेयर किया जा सके

प्रोसेस और टूल

• दस्तावेज़ बनाने की ऐसी प्रोसेस बनाएं जो 'दस्तावेज़ों का सीज़न' प्रोग्राम के बाद भी जारी रहे. साथ ही, इसमें पूरी कम्यूनिटी योगदान दे सके
• दस्तावेज़ की समीक्षा में कम से कम उतना ही समय लगेगा जितना कोड की समीक्षा में लगता है. साथ ही, यह भी उतनी ही बारीकी से की जाती है. इसलिए, पक्का करें कि आपने इसके लिए ज़रूरत के मुताबिक समय दिया हो

साफ़ तौर पर जानकारी देने के लिए, कुछ सुझावों में बदलाव किया गया है और उन्हें छोटा किया गया है.

साल 2021 के कार्यक्रम की तरह, सीज़न ऑफ़ डॉक्स 2022 में ज़्यादातर तकनीकी लेखकों ने सीधे उन संगठनों के लिए आवेदन किया जिनके साथ उन्होंने काम किया था.

तकनीकी लेखकों के साथ काम करने में आने वाली सामान्य समस्याएं

2022 के प्रोग्राम में, तकनीकी लेखकों के साथ काम करने में कम प्रोजेक्ट को समस्याएं हुईं. बीमारी, फ़ुल-टाइम नौकरी या समय से कार्यक्रम पूरा न कर पाने की वजह से, तकनीकी लेखक इस कार्यक्रम को पूरा नहीं कर पाए.

एक प्रोजेक्ट ने बताया कि उनका दस्तावेज़ बनाने वाला प्रोजेक्ट, Google Summer of Code के तहत किए जा रहे काम पर निर्भर था. साथ ही, उन निर्भरताओं को मैनेज करना मुश्किल था. एक अन्य प्रोजेक्ट में समस्याएं तब आईं, जब उनके तकनीकी लेखक को जिस हार्डवेयर की जानकारी देनी थी उसे उनके देश के रक्षा मंत्रालय ने जब्त कर लिया था. साथ ही, उसे इंपोर्ट नहीं किया जा सका.

फ़ॉलो-अप सर्वे

साल 2022 में हिस्सा लेने वाले लोगों को, साल 2023 में मई, अगस्त, और नवंबर में तीन फ़ॉलोअप सर्वे भेजे जाएंगे. नतीजे मिलने के बाद, हम इस सेक्शन को अपडेट कर देंगे.

आने वाले समय में पूछे जाने वाले सवाल

हमेशा की तरह, ओपन सोर्स में दस्तावेज़ों के बारे में जितनी ज़्यादा जानकारी मिलती है, हम उतना ही ज़्यादा जानना चाहते हैं!

आने वाले सीज़न में, हमें उम्मीद है कि:

• प्रोजेक्ट के मेटाडेटा को इकट्ठा करें, ताकि प्रोजेक्ट की उम्र, कम्यूनिटी के साइज़ या भाषा और दस्तावेज़ की ज़रूरतों के बीच के संबंधों का पता लगाया जा सके
• दस्तावेज़ से जुड़े प्रोजेक्ट का विश्लेषण करके यह देखना कि उन्हें शेयर किए जा सकने वाले टेंप्लेट में बदला जा सकता है या नहीं
• ओपन सोर्स प्रोजेक्ट में तकनीकी लेखकों के साथ इंटरव्यू करने के लिए, रूब्रिक बनाना

हालांकि, हमें कई सवालों के जवाब चाहिए, लेकिन हम ओपन सोर्स प्रोजेक्ट के उन एडमिन और मैनेजर के समय का भी सम्मान करना चाहते हैं जो सीज़न ऑफ़ द डॉक्स में हिस्सा लेते हैं. इस प्रोग्राम की मुख्य प्राथमिकता, दस्तावेज़ों की मदद से प्रोजेक्ट की समस्याओं को हल करने में उनकी मदद करना है.