इस पेज पर Google Docs के सीज़न के लिए स्वीकार किए गए एक तकनीकी लेखन प्रोजेक्ट की जानकारी है.
प्रोजेक्ट की खास जानकारी
- ओपन सोर्स संगठन:
- जैंगो
- तकनीकी लेखक:
- गैबीप्रेशियस
- प्रोजेक्ट का नाम:
- उपयोगकर्ता के लिए ज़्यादा आसान और आसानी से नेविगेट करने के लिए, योगदान गाइड को फिर से लिखें
- प्रोजेक्ट की अवधि:
- मानक अवधि (तीन महीने)
प्रोजेक्ट का विवरण
असर
अन्य दस्तावेज़ों की तरह ही, Django की योगदान गाइड का मकसद भी लोगों को गाइड करना है. इस गाइड का मकसद, ओपन सोर्स में योगदान देने वाले लोगों को इस बारे में जानकारी देना है कि वे कैसे और कहां योगदान देकर, Django को बेहतर और ईको-फ़्रेंडली बनाने में मदद कर सकते हैं.
खास तौर पर ऐसे दस्तावेज़ बनाने की ज़रूरत हमेशा पड़ती है जिनसे समुदाय और जांगो पर बहुत ज़्यादा असर पड़ता हो.
इस साल के Google समर ऑफ़ Docs में, Django का लक्ष्य है कि योगदान की गाइड को आसान और बेहतर तरीके से इस्तेमाल किया जा सके. साथ ही, योगदान देने वालों का स्वागत भी किया जा सके. यह एक ऐसा लक्ष्य है जो ज़रूरी है, क्योंकि इससे उन योगदान देने वालों को बढ़ावा मिलता है जिनसे मैं जुड़ा हूं, ताकि मैं इस बेहतरीन फ़्रेमवर्क में योगदान देना शुरू कर सकूं.
मौजूदा स्थिति
दस्तावेज़ का मौजूदा चरण जो यहां देखा जा सकता है, वह बहुत ज़्यादा गाइड नहीं है, क्योंकि यह बहुत मुश्किल है और इसे अच्छी तरह से नहीं बनाया गया है. इससे, Django में योगदान को कम समझ में आता है और यह नए योगदान देने वालों का स्वागत नहीं करता है.
प्रोजेक्ट के लक्ष्य
मैंने दस्तावेज़ के लिए अपने सुझावों के बारे में फ़ोरम में अपने मेंटॉर कार्लटन गिब्सन के साथ बातचीत की. उन्होंने स्वीकार किया कि इससे मौजूदा दस्तावेज़ की बड़ी समस्या को हल करने में मदद मिलेगी. यहां वे लक्ष्य दिए गए हैं जिन्हें मैंने, दस्तावेज़ को फिर से बनाने के लिए बनाया है: दस्तावेज़ को फिर से स्ट्रक्चर करना सेक्शनल 'क्या करें' और 'क्या न करें' अनुरोध करने और सुविधाएं बनाने जैसे छोटे-छोटे सेक्शन के लिए एक पेज बनाना कम और सीधे पॉइंट वाले दस्तावेज़ शब्दों का शब्दावली नई गाइड के मुताबिक बनाया गया इंटरनल इंडेक्स नए गाइड के मुताबिक काम का इंटरनल इंडेक्स दस्तावेज़ों को दो मुख्य हिस्सों में बांटना (कॉन्टेंट को दो मुख्य हिस्सों में बांटना/कॉन्टेंट लिखने वाले और योगदान देने वालों के लिए बेहतर स्टैंडर्ड सेक्शन बनाना.
मौजूदा दस्तावेज़ पहले से ही बेहतर योगदान देने वालों के लिए है और इससे नए और पहली बार योगदान देने वाले लोगों को ओपन सोर्स और Django दोनों का इस्तेमाल करने का मौका नहीं मिलता है. यहां शुरुआत करने वालों के लिए कुछ अतिरिक्त जानकारी दी गई है: वह सेक्शन जो योगदान देने वालों के अलग-अलग सेट(तकनीकी लेखक, डिज़ाइनर, और डेवलपर) की जानकारी देता है वह पेज जिसमें टाइमर की समस्याओं और हल की जा सकने वाली आसान समस्याओं के बारे में बताया जाता है. मौजूदा दस्तावेज़ों के कुछ सेक्शन लें, उन्हें फिर से लिखें, और नए लोगों के लिए सेक्शन में जोड़ें. वे सेक्शन जो बेहतर सेक्शन में इस्तेमाल की गई मुख्य बातों या शब्दों के बारे में बताते हैं.
टाइमलाइन
यहां इस बारे में जानकारी दी गई है कि मुझे अपने प्रोजेक्ट के लक्ष्य पर काम करने के लिए क्या करना है. इस बारे में, Google से मिले कैलेंडर में बताया गया है.
समुदाय से जुड़ने का हफ़्ता( 17 अगस्त - 13 सितंबर) समुदाय के साथ ज़्यादा जुड़ने के लिए तकनीकी दस्तावेज़ अपडेट करना 1 नए लेख लिखने वाले दस्तावेज़ बनाना और नए लेखक से जुड़े दस्तावेज़ तैयार करना दस्तावेज़ों में योगदान देना जारी रखना योगदान देने वालों से ज़्यादा सुझाव पाना मौजूदा दस्तावेज़ों और सही टूल का ज़्यादा अध्ययन लेवल के हिसाब से सेक्शन से जुड़े दस्तावेज़ बनाना शुरू करना दस्तावेज़ बनाने वालों के लिए शुरुआती सेक्शन बनाना शुरुआती दस्तावेज़ तैयार करना शुरुआती दस्तावेज़ तैयार करना और नए लेखों के लिए गाइड बनाना
टूल
स्फ़िंक्स - मौजूदा दस्तावेज़ के लिए मौजूदा टूल. दस्तावेज़ पढ़ें.
यह प्रोजेक्ट ही क्यों?
मैं अच्छी तरह से लिखे गए दस्तावेज़ों और लेखों में बहुत ज़्यादा भरोसा रखता हूं, जिनकी मदद से वे दुनिया के किसी भी हिस्से में रहते हैं. इसके अलावा, मुझे जांगो और ओपन सोर्स भी काफ़ी पसंद है. मेरा मकसद है कि मैं जांगो के लिए एक नौसिखिया काम करूं. मुझे लगता है कि यह मेरे पसंदीदा टूल को बेहतर बनाने का शानदार तरीका है. साथ ही, मुझे कोडबेस के बारे में पता है, ताकि मैं एक डेवलपर(और तकनीकी लेखक) के तौर पर ज़्यादा योगदान दे सकूं. किसी ऐसे संगठन के साथ काम करना अच्छा और खूबसूरत होगा जो मेरे विचारों से मेल खाता हो और मेरे पूरे करियर का एक अच्छा टूल रहा हो.
इस प्रोजेक्ट के लिए मैं सही व्यक्ति क्यों हूं?
मेरा मानना है कि मैं सही व्यक्ति हूं और इन खातों के आधार पर मैं सही हूं: मैं जैंगो के सिद्धांत को बेहतर तरीके से समझने में नए लोगों की मदद करने के लिए लेख लिख कर जैंगो में योगदान दे रहा हूं. एक डेवलपर होने के नाते और मैं जांगो के लिए योगदान देने के लिए उत्सुक हूं, मैं साथी डेवलपर की ज़रूरत को समझता हूं और यह समझता हूं कि उनके लिए इसे अच्छी तरह से दर्ज कैसे करना है. मैं टीम प्लेयर हूं और अपने मेंटॉर कार्लटन गिब्सन की निगरानी में ही अच्छी तरह से काम करूंगा/करूंगी.