मौजूदा फ़ेज़:
Docs का सीज़न 2021 प्रोग्राम 14 दिसंबर, 2021 को खत्म हो गया. टाइमलाइन देखें.
अपने संगठन के प्रोजेक्ट का प्रस्ताव बनाने के लिए, इस गाइड को टेंप्लेट के तौर पर इस्तेमाल करें.
PROPOSAL TITLE - organization name
आपके प्रस्ताव का टाइटल छोटा और खास होना चाहिए. “Update ORGNAME Contributor Guide” एक अच्छा प्रस्ताव टाइटल है. “दस्तावेज़ में सुधार” बहुत ही अस्पष्ट है; “योगदान देने वाले लोगों के लिए बनी गाइड के सेक्शन 5,7,23,99 को अपडेट करें, अक्सर पूछे जाने वाले सवाल बनाएं, और स्टाइल गाइड बनाएं” बहुत लंबा है.
आपके संगठन के बारे में जानकारी
इस सेक्शन में, हमें अपने संगठन या प्रोजेक्ट के बारे में कुछ छोटे पैराग्राफ़ में बताएं. आपका प्रोजेक्ट किस समस्या को हल करता है? आपके उपयोगकर्ता और योगदान देने वाले लोग कौन हैं? आपका संगठन या प्रोजेक्ट कितने समय से मौजूद है? हमें इस बारे में जानकारी दें कि आपके प्रस्ताव को फ़ंड करने से, ओपन सोर्स और दुनिया पर क्या असर पड़ेगा.
GloriousPickle (मौजूदा वर्शन 1.2.3, पहली बार 2009 में रिलीज़ हुई) एक लाइब्रेरी है, जिसे MIT से लाइसेंस मिला है. इसकी मदद से, अचार बनाने के लिए इस्तेमाल की जा सकने वाली हर सब्जी के लिए, नमक, चीनी, सिरका, और मसालों के सही अनुपात का हिसाब आसानी से लगाया जा सकता है. इस लाइब्रेरी में, एक छोटे ककड़ी से लेकर कंटेनर-शिप में भरी हुई मूली तक की संख्या शामिल है. हमारे योगदान देने वाले लोग, दुनिया भर में अचार बनाने के शौकीन हैं. साथ ही, हमारे उपयोगकर्ताओं में घर पर खाना बनाने वाले लोग, रेस्टोरेंट के शेफ़, और खाद्य प्रसंस्करण करने वाली बड़ी कंपनियों और संगठनों के लॉजिस्टिक में काम करने वाले लोग शामिल हैं. हमारा सबसे बड़ा उपयोगकर्ता एक ऐसा संगठन है जो फ़ूड बैंक को जल्दी खराब होने वाली सब्ज़ियों को अचार के जार में बदलने में मदद करता है. इससे कई समुदायों में भूखे लोगों को खाना खिलाने और खाने की बर्बादी को कम करने में मदद मिलती है. इसके अलावा, हमारे उपयोगकर्ता हमें GloriousPickle के इस्तेमाल के बारे में वैकल्पिक मेट्रिक भेजते हैं. हम इनका इस्तेमाल, PickleSet बनाने के लिए करते हैं. यह मशीन लर्निंग की मदद से, अचार की नई रेसिपी बनाने के लिए एक बड़ा डेटासेट है.
आपके प्रोजेक्ट के बारे में जानकारी
आपके प्रोजेक्ट की समस्या
हमें उस समस्या के बारे में बताएं जिसे आपके प्रोजेक्ट से हल करने में मदद मिलेगी. आपके संगठन या प्रोजेक्ट के लिए, इस समस्या को हल करना क्यों ज़रूरी है?
उपयोगकर्ता, GloriousPickle टूल में नए मसालों और अन्य चीज़ों की जानकारी जोड़ना चाहते हैं. खास तौर पर, यूरोप के बाहर के व्यंजनों में इस्तेमाल होने वाली चीज़ों की जानकारी. माफ़ करें, इस जानकारी को जोड़ने की प्रोसेस के बारे में अच्छी तरह से जानकारी नहीं दी गई है. इसका मतलब है कि योगदान देने वाले लोगों को मदद पाने के लिए, प्रोजेक्ट में कोई समस्या खोलनी होगी या वे पूरी तरह से इस प्रोजेक्ट को छोड़ देंगे. इस प्रोसेस में यह भी माना जाता है कि योगदान देने वाले लोग, GitHub और हमारे पुलबैक अनुरोध की प्रोसेस के बारे में पहले से ही जानते हैं. हालांकि, हमारे कई उपयोगकर्ता पेशेवर डेवलपर नहीं हैं.
हमारे पास जितनी ज़्यादा जानकारी होगी, हमारे सभी उपयोगकर्ताओं के लिए GloriousPickle उतना ही ज़्यादा काम का होगा!
आपके प्रोजेक्ट का दायरा
हमें बताएं कि आपका संगठन कौनसा दस्तावेज़ बनाएगा, अपडेट करेगा या बेहतर बनाएगा. अगर कोई काम जान-बूझकर नहीं किया जा रहा है, तो उस जानकारी को भी शामिल करें. इसमें प्रोजेक्ट पूरा होने में लगने वाले समय का अनुमान शामिल करें. साथ ही, यह भी बताएं कि आपने अपने प्रोजेक्ट के लिए, संगठन के वॉलंटियर और तकनीकी लेखक की पहचान पहले से कर ली है या नहीं.
GloriousPickle प्रोजेक्ट (कोड नेम PicklePlus) में ये काम किए जाएंगे:
- मौजूदा दस्तावेज़ों का ऑडिट करें और इस्तेमाल के तीन सबसे ज़्यादा इस्तेमाल होने वाले उदाहरणों (नया इंग्रीडिएंट जोड़ना, वैरिएंट इंग्रीडिएंट जोड़ना, और इंग्रीडिएंट की जानकारी अपडेट करना या उसमें सुधार करना) के लिए, मौजूदा दस्तावेज़ों का फ़्रिक्शन लॉग बनाएं.
- दस्तावेज़ में मौजूद गैप को समझने के लिए, फ़्रिक्शन लॉग को गाइड के तौर पर इस्तेमाल करें. साथ ही, सबसे ज़्यादा इस्तेमाल होने वाले उदाहरणों के लिए, अपडेट किया गया दस्तावेज़ बनाएं.
- योगदान देने वाले ऐसे लोगों के लिए एक छोटी “चेट शीट” बनाएं जो पुल रिक्वेस्ट और GitHub का इस्तेमाल पहली बार कर रहे हैं. इससे उन्हें हमारी प्रोसेस का इस्तेमाल करने में मदद मिलेगी.
- दस्तावेज़ की जांच करने वाले लोगों (प्रोजेक्ट में काम करने वाले वॉलंटियर) और GloriousPickle की पूरी कम्यूनिटी से मिले सुझावों और राय को शामिल करें.
- GloriousPickle की साइट पर दस्तावेज़ों को अपडेट करने के लिए, रिलीज़ टीम के साथ मिलकर काम करें. साथ ही, आने वाले समय में दस्तावेज़ों को अपडेट टूल के साथ सिंक रखने के लिए एक प्रोसेस बनाएं.
इस प्रोजेक्ट के दायरे से बाहर का काम:
- इस प्रोजेक्ट से, एक ही इंग्रीडिएंट की अलग-अलग स्पेलिंग या नामों को क्रॉस-लिंक करने की प्रोसेस नहीं बनाई जाएगी.
- इस प्रोजेक्ट में, GitHub पर कोई ट्यूटोरियल नहीं बनाया जाएगा. इसके बजाय, चैट शीट में काम के और मददगार मौजूदा कॉन्टेंट के लिंक दिए जाएंगे.
इस प्रोजेक्ट के लिए, हमारे पास तकनीकी लेखन के दो अच्छे उम्मीदवार हैं. हमारा अनुमान है कि इस काम को पूरा करने में तीन महीने लगेंगे. GloriousPickle PickleDocs SIG और @GloriousPicklePat (इंग्रीडिएंट जोड़ने वाले एपीआई के मुख्य मैनेजर) ने इस प्रोजेक्ट को मदद करने का वादा किया है.
अपने प्रोजेक्ट की सफलता का आकलन करना
आपको कैसे पता चलेगा कि आपके नए दस्तावेज़ से आपकी समस्या हल हुई है? आपको किन मेट्रिक का इस्तेमाल करना है और उन्हें कैसे ट्रैक करना है?
GloriousPickle को हर तिमाही में, नए इंग्रीडिएंट जोड़ने या अपडेट करने के लिए, औसतन 10 पुल रिक्वेस्ट मिलते हैं. इन इंग्रीडिएंट को ‘ingredient’ टैग किया जाता है. इनमें से ज़्यादातर पुल रिक्वेस्ट (>60%) पहले योगदान देने वाले लोगों से मिलते हैं. हमारा मानना है कि बेहतर दस्तावेज़ से, ज़्यादा पुश अनुरोध मिलेंगे. साथ ही, नए योगदान देने वालों से भी ज़्यादा पुश अनुरोध मिलेंगे. हमारे ज़्यादातर सक्रिय योगदानकर्ताओं ने, कॉन्टेंट में सामग्री जोड़कर शुरुआत की थी. इसलिए, हमें लगता है कि इस दस्तावेज़ को बेहतर बनाने से, ज़्यादा से ज़्यादा लोग योगदान देंगे.
दस्तावेज़ पब्लिश होने के बाद, हम हर महीने दो मेट्रिक ट्रैक करेंगे. इनमें, इंग्रीडिएंट से जुड़े पुल रिक्वेस्ट की संख्या और नए योगदानकर्ताओं के पुल रिक्वेस्ट की संख्या शामिल है. हम उन लोगों की संख्या भी ट्रैक करेंगे जिन्होंने तीन से ज़्यादा योगदान दिए हैं. दस्तावेज़ पब्लिश होने के बाद, हर तीन महीने में यह ट्रैकिंग शुरू की जाएगी.
हम इस प्रोजेक्ट को तब ही सफल मानेंगे, जब नए दस्तावेज़ पब्लिश होने के बाद:
- इंग्रीडिएंट से जुड़े पुल अनुरोधों की संख्या में 20% की बढ़ोतरी हुई
- नए योगदानकर्ताओं के पुलबैक अनुरोधों की संख्या में 15% की बढ़ोतरी हुई
- दस्तावेज़ पब्लिश होने के बाद की तिमाही में, तीन से ज़्यादा योगदान देने वाले लोगों की संख्या में 10% की बढ़ोतरी हुई
प्रोजेक्ट का बजट
सामान्य दिशा-निर्देश
- अपने बजट को प्रस्ताव में या अलग लिंक के तौर पर शामिल किया जा सकता है. अगर आपके बजट में 10 आइटम से कम हैं, तो हमारा सुझाव है कि आप उन्हें अपने प्रस्ताव में शामिल करें.
- सभी बजट डॉलर में होने चाहिए. हमारा अनुमान है कि अनुदान 5,000 से 15,000 डॉलर के बीच होगा. अगर आपका प्रोजेक्ट इस रेंज से बाहर है, तो कृपया अपने बजट की पुष्टि करने के लिए ज़्यादा जानकारी दें.
- हमारा अनुमान है कि आपके बजट का ज़्यादातर हिस्सा (कम से कम 60-70%) आपके प्रोजेक्ट पर काम करने वाले तकनीकी लेखक को दिया जाएगा. हमारा सुझाव है कि जहां भी हो सके, हर प्रोजेक्ट के हिसाब से बजट तय करें.
- हमारा सुझाव है कि ओपन सोर्स प्रोजेक्ट में, जब भी मुमकिन हो ओपन सोर्स टूल का इस्तेमाल करें. अगर आपके प्रोजेक्ट को मालिकाना हक वाले सॉफ़्टवेयर के लाइसेंस या सहायता के लिए ज़रूर तौर पर फ़ंड की ज़रूरत है, तो कृपया रकम के लिए वजह बताएं.
- अन्य संभावित खर्चों में ये शामिल हैं:
- दस्तावेज़ों की साइट के लिए ब्रैंडिंग, लोगो, टेंप्लेट या अन्य डिज़ाइन ऐसेट बनाने के लिए डिज़ाइन वर्क
- प्रोजेक्ट के लिए कम से कम रकम (<200 डॉलर), जैसे कि प्रतिभागियों के लिए टी-शर्ट या स्टिकर. अगर Season of Docs के लोगो का इस्तेमाल किया जाता है, तो उसके साथ आपके प्रोजेक्ट या संगठन का लोगो या नाम होना चाहिए. आपके उपहार में Google का नाम नहीं दिया जा सकता.
- प्रोजेक्ट में मेंटर या गाइड की भूमिका निभाने वाले वॉलंटियर को कम से कम स्टाइपेंड दिया जाना चाहिए. हमारा सुझाव है कि हर वॉलंटियर को 500 डॉलर से ज़्यादा न दिया जाए
- अन्य ओपन सोर्स प्रोजेक्ट को मिलने वाले दान, आपके कुल बजट का 10% से ज़्यादा नहीं होने चाहिए.
- ज़रूरत के हिसाब से बजट के अन्य आइटम शामिल करें. साथ ही, मांगी गई रकम की वजह भी बताएं. खर्च की वजहों में यह हाइलाइट किया जाना चाहिए कि खर्च से प्रोजेक्ट की सफलता में कैसे मदद मिलेगी.
सैंपल बजट
| बजट आइटम | रकम | कुल मौजूदा कन्वर्ज़न | नोट/जस्टिफ़िकेशन |
|---|---|---|---|
| तकनीकी लेखक, GloriousPickle के लिए, आइटम जोड़ने की प्रोसेस के नए दस्तावेज़ की ऑडिट, अपडेट, जांच, और पब्लिश करता है | 5,000.00 | 5,000.00 | |
| वॉलंटियर को मिलने वाला स्टाइपेंड | 500 | 6,500.00 | तीन वॉलंटियर को 500-500 रुपये |
| प्रोजेक्ट की टी-शर्ट (10 टी-शर्ट) | 150.00 | 6650.00 | |
| बड़ा इंफ़्लैटेबल यूनिकॉर्न (15 फ़ुट का वर्शन) | 99.99 | 6,749.99 | हम उस टीम को इनफ्लेट होने वाला यूनिकॉर्न देंगे जो प्रोजेक्ट के डेवलपमेंट के दौरान, तकनीकी लेखक के सवालों के सबसे तेज़ जवाब देगी |
| कुल | 6,749.99 |
अतिरिक्त जानकारी
अपने प्रस्ताव से जुड़ी कोई भी अन्य जानकारी यहां शामिल करें.
तकनीकी लेखकों या दस्तावेज़ों के साथ पहले का अनुभव: अगर आपने या आपके किसी मेंटर ने पहले तकनीकी लेखकों के साथ काम किया है या दस्तावेज़ तैयार किए हैं, तो अपने आवेदन में इस बारे में बताएं. अपने बनाए गए दस्तावेज़ों के बारे में बताएं. साथ ही, यह भी बताएं कि आपने तकनीकी लेखक के साथ कैसे काम किया. उदाहरण के लिए, समीक्षा की उन प्रक्रियाओं के बारे में बताएं जिनका आपने इस्तेमाल किया था या फिर बताएं कि तकनीकी लेखक की स्किल आपके प्रोजेक्ट के लिए कैसे काम की थीं. बताएं कि इस अनुभव से, आपको Google Season of Docs में तकनीकी लेखक के साथ काम करने में कैसे मदद मिल सकती है.
Season of Docs, Google Summer of Code या किसी दूसरे कार्यक्रम में पहले हिस्सा लिया है या नहीं: अगर आपने या आपके किसी मेंटर ने Google Summer of Code या किसी मिलते-जुलते कार्यक्रम में हिस्सा लिया है, तो अपने आवेदन में इसकी जानकारी दें. उस प्रोग्राम में अपनी उपलब्धियों के बारे में बताएं. बताएं कि इस अनुभव से, Google Season of Docs में आपके काम करने के तरीके पर क्या असर पड़ सकता है.