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

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

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

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

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

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

Season of Docs कैसे काम करता है

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 में, Season of Docs प्रोग्राम के तहत, 67 ऐप्लिकेशन में से 31 प्रोजेक्ट स्वीकार किए गए. इनमें से 30 प्रोजेक्ट ने प्रोग्राम को सफलतापूर्वक पूरा किया. स्वीकार किए गए 31 संगठनों में से 17 संगठनों ने पहले भी आवेदन किया था.

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

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

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

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

Season of Docs के साल 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 के प्रोग्राम में, संगठनों को दस्तावेज़ों से जुड़ी ये समस्याएं हल करनी थीं:

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

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

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

केस स्टडी में, दस्तावेज़ों के इन टाइप का भी ज़िक्र किया गया:

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

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

ज़्यादा जानकारी के लिए, Season of Docs के साल 2022 के नतीजों वाला पेज देखें. इस पेज पर, हर संगठन के लिए प्रोजेक्ट के ओरिजनल प्रपोज़ल और पूरी केस स्टडी के लिंक दिए गए हैं.

बजट

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

मीट्रिक

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

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

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

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

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

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

ज़्यादा जानकारी के लिए, Season of Docs के साल 2022 के नतीजों वाला पेज देखें. इस पेज पर, हर संगठन के लिए प्रोजेक्ट के ओरिजनल प्रपोज़ल और पूरी केस स्टडी के लिंक दिए गए हैं.

टेक्निकल राइटर के साथ काम करना

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

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

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

भर्ती करना

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

काम पर रखना

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

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

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

प्रोसेस और टूलिंग

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

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

साल 2021 के प्रोग्राम की तरह, Season of Docs के साल 2022 के प्रोग्राम में भी ज़्यादातर टेक्निकल राइटर ने उन संगठनों को सीधे तौर पर आवेदन किया जिनके साथ उन्होंने काम किया.

टेक्निकल राइटर के साथ काम करने में आने वाली सामान्य समस्याएं

साल 2022 के प्रोग्राम में, कम प्रोजेक्ट ने अपने टेक्निकल राइटर के साथ काम करने में आने वाली समस्याओं की रिपोर्ट की. टेक्निकल राइटर का प्रोग्राम पूरा न कर पाना, सबसे बड़ी समस्या थी. इसकी वजह, बीमार होना, फ़ुल-टाइम नौकरी करना या समय से जुड़ी प्रतिबद्धता पूरी न कर पाना था.

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

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

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

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

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

आने वाले सीज़न में, हम ये काम करना चाहते हैं:

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

हालांकि, ऐसे कई सवाल हैं जिनकी जांच हम करना चाहते हैं. साथ ही, हम Season of Docs में हिस्सा लेने वाले ओपन सोर्स प्रोजेक्ट के एडमिन और मेंटेनर के समय की भी अहमियत समझते हैं. प्रोग्राम की सबसे अहम प्राथमिकता, दस्तावेज़ों से जुड़ी समस्याओं को हल करने में प्रोजेक्ट की मदद करना है.