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

मौजूदा चरण:
Docs प्रोग्राम का 2021 सीज़न 14 दिसंबर, 2021 को खत्म हो गया है. टाइमलाइन देखें.

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

Docs के सीज़न के बारे में जानकारी

सीज़न ऑफ़ Docs एक ईको-फ़्रेंडली प्रोग्राम है. इसे Google Open Source Programs Office मैनेज करता है. Docs के सीज़न के मकसद हैं:

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

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

2021 के कार्यक्रम की खास जानकारी

साल 2021 में कार्यक्रम में हुए बदलाव

साल 2019 और 2020 में, सभी संगठनों और तकनीकी लेखकों ने 'Docs का सीज़न' के लिए अलग-अलग आवेदन किया था. साथ ही, तकनीकी लेखकों को 'Docs ऑफ़ Docs प्रोग्राम के एडमिन' ने संगठनों से मिलाया था. संगठनों ने तकनीकी लेखकों के साथ काम करने के लिए, मेंटॉर उपलब्ध कराए. इन लेखकों को उनकी जगह के आधार पर, उनके काम के लिए वफ़ादारी दी जाती है. प्रोग्राम में यह मेज़र किया गया कि तकनीकी लेखक, मेंटॉर, और संगठन के एडमिन, प्रोग्राम में अपनी भागीदारी से संतुष्ट हैं या नहीं. हालांकि, उन्होंने दस्तावेज़ों के नतीजों को नहीं मापा.

सीज़न ऑफ़ Docs की टीम ने 2021 में, इस प्रोग्राम में अहम बदलाव किए. इसका पूरा ध्यान दस्तावेज़ के नतीजों को मेज़र करने पर लगाया. साथ ही, संगठनों और तकनीकी लेखकों को ज़्यादा सुविधाएं मुहैया कराने पर ध्यान दिया.

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

2021 की सामान्य खोज

संगठन

• साल 2021 के कार्यक्रम में किए गए बदलावों की वजह से, कम संगठन आवेदन कर पाए. साल 2020 के मुकाबले 2021 में 30% कम संगठनों ने आवेदन किया. हालांकि, 2020 में संगठन के एडमिन, 2020 में लागू होने वाले एडमिन (93% बनाम 91%) की तुलना में, इस कार्यक्रम से थोड़ा ज़्यादा संतुष्ट थे.

समस्याएं, सिद्धांत, और मेट्रिक

• ज़्यादातर प्रोजेक्ट का मकसद, मेंटेनेंस का बोझ कम करने (समस्याओं/सवालों को कम करके) और/या प्रोजेक्ट में लोगों की भागीदारी को बढ़ाना (या तो प्रोजेक्ट इस्तेमाल करने वाले लोगों या योगदान देने वालों) के लिए दस्तावेज़ बनाना था.
  • स्वीकार किए गए 50% संगठनों ने ट्यूटोरियल या 'कैसे करें' निर्देशों वाला कॉन्टेंट बनाया है.
  • स्वीकार किए गए 50% से ज़्यादा संगठनों ने माना कि उनके मौजूदा दस्तावेज़ में कोई बदलाव नहीं है, उन्हें व्यवस्थित नहीं किया गया है या पुराना बताया गया है.
• प्रोजेक्ट आम तौर पर इंटरैक्शन के ज़रिए अपने दस्तावेज़ों के असर को मापना चाहते थे. खास तौर पर, कम समस्याएं बताई गई थीं और दस्तावेज़ देखने और प्रोजेक्ट में हिस्सा लेने वाले लोगों की संख्या ज़्यादा थी.
• नवंबर 2022 तक, 30 में से 25 प्रोजेक्ट के लिए ये काम किए जा रहे थे:
  • 18 प्रोजेक्ट ने कहा कि वे अपनी मूल मेट्रिक के मुताबिक थे
  • पांच प्रोजेक्ट, अपडेट की गई मेट्रिक के मुताबिक थे
  • 2 प्रोजेक्ट ने कहा कि जानकारी अभी काफ़ी जल्दी है

प्रोग्राम में हिस्सा लेना

• संगठन के एडमिन के लिए, तकनीकी लेखकों को नौकरी पर रखना, उन्हें नौकरी पर रखना, और उन्हें पैसे देना, इस प्रोग्राम का सबसे मुश्किल हिस्सा था.
• नवंबर 2022 तक, 30 में से 24 संगठनों ने यह जानकारी दी है:
  • 18 संगठन अब भी अपने 'Docs ऑफ़ Docs' के टेक्निकल लेखकों के साथ काम कर रहे थे (या तो जारी रखने वाले योगदान देने वाले के तौर पर या सवालों के जवाब देने वाले संसाधन के तौर पर)
    • चार संगठन, Docs में तकनीकी लेखकों के सीज़न के लिए, पैसे चुकाकर लिए जाने वाले तकनीकी लेखकों के साथ काम कर रहे थे

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

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

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

साल 2021 में, 82 संगठनों ने इस कार्यक्रम में आवेदन किया और 30 ओपन सोर्स संगठनों को इस कार्यक्रम में शामिल किया गया. (चुनने के लिए ज़रूरी शर्तों के बारे में जानने के लिए, आवेदन करने का गाइड देखें.) हिस्सा लेने वाले संगठनों की पूरी सूची Docs की वेबसाइट पर देखी जा सकती है. स्वीकार किए गए सभी 30 संगठनों ने 2021 के कार्यक्रम में अपनी भागीदारी पूरी करने के लिए, अपनी केस स्टडी सबमिट कर दी है.

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

Docs 2021 के सीज़न में हिस्सा ले रहे संगठनों ने, अलग-अलग तरह के ओपन सोर्स प्रोजेक्ट का प्रतिनिधित्व किया. साल 2021 में, एक जैसे उपयोगकर्ताओं के ग्रुप में ये शामिल हैं:

• बड़े लैंग्वेज प्रोजेक्ट, जैसे कि Julia, Perl, और R
• शिक्षा, जलवायु, फ़िनटेक, हेल्थकेयर, लाइब्रेरी सर्विस, मशीन लर्निंग, मास स्पेक्ट्रोमेट्री, पब्लिक कॉन्ट्रैक्ट, और रोबोटिक्स से जुड़े प्रोजेक्ट
• डेवलपर को ध्यान में रखकर बनाए जाने वाले प्रोजेक्ट, जिनमें केऑस इंजीनियरिंग टूल, फ़ज़र, चैटबॉट SDK टूल, सॉफ़्टवेयर कंपोज़िशन विश्लेषण पाइपलाइन, परफ़ॉर्मेंस पर निगरानी रखने वाले टूल, और विज़ुअल प्रोग्रामिंग टूल शामिल हैं
• दस्तावेज़ से जुड़े टूल के लिए, दस्तावेज़ वाले प्रोजेक्ट. जैसे, Redocly और Metanorma.

Python नेटवर्क प्रोजेक्ट, सबसे बड़ी सब-कैटगरी थे. साल 2021 में, इन समानता रखने वाले लोगों में ArviZ, NumPy, MicroPython, PyMC3, PyTorch-Ignite, और SymPy शामिल थे.

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

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

साल 2021 में संगठनों ने दस्तावेज़ के तौर पर जिन समस्याओं के बारे में बताया है वे ओपन सोर्स प्रोजेक्ट और तकनीकी दस्तावेज़, दोनों में काफ़ी आम हैं.

संगठन, 2021 के प्रोग्राम में इन मुख्य समस्याओं को हल करने की उम्मीद कर रहे थे:

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

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

साल 2021 की केस स्टडी में, सबसे ज़्यादा तरह के दस्तावेज़ों में ट्यूटोरियल को शामिल किया गया था.

केस स्टडी में अलग-अलग तरह के दस्तावेज़ों के बारे में बताया गया है. इनमें Docs-as-code पाइपलाइन, डायग्राम, शब्दावली, स्टाइल गाइड, अक्सर पूछे जाने वाले सवाल, इंटरनेशनलाइज़ेशन, कोडलैब, कॉन्टेंट मॉडल, मॉड्यूल, कॉन्सेप्ट का दस्तावेज़, गड़बड़ी के मैसेज, उपयोगकर्ता पर रिसर्च, Readme, नॉलेज बेस जैसी जानकारी शामिल है.

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

कई प्रोजेक्ट में, अलग-अलग तरह के दस्तावेज़ों के लिए दिशा-निर्देश के तौर पर, Diátऐक्सिस फ़्रेमवर्क का इस्तेमाल करने के बारे में बताया गया है.

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

बजट

साल 2021 में, औसत बजट अनुरोध 10,200 डॉलर और मीडियन 10,000 डॉलर था. सिर्फ़ तीन संगठनों ने ज़्यादा से ज़्यादा संभावित अनुदान (15 हज़ार डॉलर) का अनुरोध किया और बाकी तीन संगठनों ने सबसे कम अनुदान (पांच हज़ार डॉलर) का अनुरोध किया.

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

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

सुझाए गए टॉप मेट्रिक ये थे:

अन्य प्रस्तावित मेट्रिक में GitHub स्टार, पेज पर बिताया गया समय, मेल पाने वाले उपयोगकर्ताओं की सूची से मिले कन्वर्ज़न, क्वालिटेटिव यूज़र टेस्टिंग, फ़ोरम में हिस्सा लेने वालों की संख्या, पार्टनर/वॉलंटियर/इंटिग्रेशन की संख्या शामिल हैं.

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

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

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

साल 2021 में, Docs प्रोग्राम के सीज़न में हुए सबसे बड़े बदलाव में, टेक्निकल राइटर के साथ प्रोजेक्ट पर काम करने का तरीका भी शामिल था. पिछले सीज़न में, तकनीकी लेखकों ने सीधे Google में आवेदन किया था और उन्हें प्रोग्राम के एडमिन से प्रोजेक्ट के साथ मिलाया गया था. उन्हें सीधे Google की ओर से एक तय वफ़ादारी दी जाती थी.

साल 2021 में, टेक्निकल राइटर ने प्रोजेक्ट के लिए सीधे तौर पर आवेदन किया और इन प्रोजेक्ट के तहत, तकनीकी लेखकों के मुआवज़े के लिए बजट सेट किया गया. इसमें, Docs के ओपन कलेक्टिव फ़ंड के सीज़न से पेमेंट किया गया.

साल 2021 के कार्यक्रम में हिस्सा ले रहे ज़्यादातर प्रोजेक्ट में, तकनीकी लेखकों को शामिल करने या उन्हें नौकरी पर रखने का बहुत कम अनुभव था या बिलकुल भी नहीं था. कई प्रोजेक्ट ने कहा कि यह प्रक्रिया ऐसे प्रोजेक्ट के तौर पर शुरू की गई थी जिसके लिए ज़्यादा मदद की ज़रूरत थी. इस सुझाव के जवाब में, सीज़न ऑफ़ Docs की टीम ने प्रोग्राम गाइड में लेखकों के लिए तकनीकी समझौतों के दस्तावेज़ जोड़े.

नौकरी के लिए सुझाव

प्रोजेक्ट को 'Docs के सीज़न' में हिस्सा लेने में दिलचस्पी रखने वाले दूसरे प्रोजेक्ट के लिए सुझाव देने के लिए कहा गया. भर्ती के सबसे बड़े सुझाव ये थे:

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

(ध्यान दें: उन सभी प्रोजेक्ट की केस स्टडी में यह नहीं बताया गया है जिनमें उन प्रोजेक्ट के लिए, तकनीकी लेखक के तौर पर काम करने वाले उम्मीदवारों को भर्ती किया गया था.)

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

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

प्रोजेक्ट को पता चला कि उन्होंने अपने समुदायों में शामिल होने या अपने प्रोजेक्ट के दस्तावेज़ टूलचेन को सेट अप करने में आने वाली मुश्किलों को कम आंका.

ओपन कलेक्टिव में बैंकिंग से जुड़ी समस्याओं की वजह से या लेखकों के घर के देशों में पेमेंट से जुड़ी पाबंदियों की वजह से, कुछ प्रोजेक्ट में तकनीकी लेखकों को पेमेंट करने में देरी हुई.

ओपन कलेक्टिव शुल्क से जुड़े प्रोग्राम के दस्तावेज़ में साफ़ तौर पर जानकारी नहीं दी गई थी: Google ने प्रोजेक्ट में फ़ंड के शुरुआती ट्रांसफ़र के लिए, ओपन कलेक्टिव ट्रांज़ैक्शन शुल्क कवर किया था, लेकिन कुछ अन्य पेमेंट चैनलों (जैसे, मुद्रा कन्वर्ज़न शुल्क) से लगाए गए लेन-देन शुल्क में नहीं. हम आने वाले प्रोग्राम के लिए, दस्तावेज़ में इसे और साफ़ करने के लिए काम करेंगे.

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

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

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

1. क्या आप अब भी सीज़न ऑफ़ Docs के तकनीकी लेखक के साथ काम कर रहे हैं?

1. अगर आपका तकनीकी लेखक अब भी आपके प्रोजेक्ट पर काम कर रहा है, तो क्या उसे किसी तरह से पैसे मिल रहे हैं?

1. इस समय, क्या आपको लगता है कि दस्तावेज़ से जुड़ा आपका प्रोजेक्ट पूरा हो गया है?

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

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

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

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