इस पेज पर, तकनीकी लेखन वाले उस प्रोजेक्ट की जानकारी दी गई है जिसे Google Season of Docs के लिए स्वीकार किया गया है.
प्रोजेक्ट की खास जानकारी
- ओपन सोर्स संगठन:
- LibreOffice
- टेक्निकल राइटर:
- Krezhairo
- प्रोजेक्ट का नाम:
- Calc के फ़ंक्शन का रेफ़रंस और उपयोगकर्ता गाइड
- प्रोजेक्ट की अवधि:
- स्टैंडर्ड अवधि (तीन महीने)
प्रोजेक्ट का विवरण
प्रोजेक्ट का अनुरोध
मैं तकनीकी लेखन के दौरान, हफ़्ते में 30 से 35 घंटे और लेखन से पहले के चरण में 10 से 12 घंटे आसानी से दे सकता हूं. इससे, मुझे प्रोजेक्ट के लिए ज़रूरी किसी भी अतिरिक्त स्किल को सीखने में मदद मिलेगी. आपको बताना चाहता/चाहती हूं कि फ़िलहाल, मैं अपने देश में अपने यूनिवर्सिटी कैंपस में रह रहा/रही हूं. यहां मेरे पास तेज़ इंटरनेट और प्रोजेक्ट के लिए ज़रूरी सभी संसाधन हैं. प्रोजेक्ट के पूरे समय तक, मैं अपने यूनिवर्सिटी कैंपस से ही काम करता/करती रहूंगा/रहूंगी. ऐसा इसलिए, क्योंकि COVID-19 की वजह से, मुझे नहीं लगता कि मेरा यूनिवर्सिटी कैंपस जल्द खुलेगा. अगर खुल भी जाता है, तो भी मुझे अपने फ़ाइनल साल में सिर्फ़ हफ़्ते में 5-6 घंटे क्लास में जाना होगा. इसलिए, प्रोजेक्ट पर इसका कोई असर नहीं पड़ेगा.
शुरुआती जानकारी
LibreOffice Calculator के पास कई कैटगरी में, फ़ंक्शन की बहुत बड़ी (+ 500) सूची है. सहायता पेज पर उन कैटगरी के दस्तावेज़ काफ़ी छोटे (लेकिन फिर भी सटीक) हैं. Calc में पहले से मौजूद फ़ंक्शन विजर्ड, उपयोगकर्ता को हर फ़ंक्शन के मकसद और पैरामीटर के बारे में खास जानकारी भी देता है. कैल्क के फ़ंक्शन के बारे में ज़्यादा जानकारी देने के लिए द डॉक्यूमेंट फ़ाउंडेशन के विकी पर एक स्ट्रक्चर बनाया गया है.
मकसद
कैल्क के हर फ़ंक्शन के लिए ज़्यादा जानकारी वाला कॉन्टेंट लिखकर, विकी स्ट्रक्चर को पॉप्युलेट करने के लिए, ओडीएफ़एफ़ स्टैंडर्ड के पालन को फ़्लैग करना, जिसमें इलस्ट्रेशन और डायग्राम भी शामिल थे, कॉर्नर केस और अपवादों के बारे में बताने के लिए एक या दो उदाहरण दिए गए और सैंपल/उदाहरण फ़ाइलें उपलब्ध कराई गईं.
प्रोजेक्ट का प्लान
मैंने इस प्रोजेक्ट के मुख्य आइडिया को अच्छी तरह से समझ लिया है. फ़ंक्शन विजर्ड में, हम हर फ़ंक्शन के काम करने के तरीके को दस्तावेज़ में शामिल करने की कोशिश कर रहे हैं. साथ ही, हर फ़ंक्शन के लिए ज़रूरत के मुताबिक उदाहरण भी शामिल किए जा रहे हैं. इन उदाहरणों में, फ़ंक्शन के सभी पहलुओं को शामिल किया गया है. हम दस्तावेज़ को ज़्यादा से ज़्यादा आसान बनाने की कोशिश कर रहे हैं, ताकि कोई नया उपयोगकर्ता कुछ ही सेकंड में इसका इस्तेमाल करने का तरीका समझ सके.
मैं इन फ़ंक्शन को कैटगरी के हिसाब से बांटूंगा:
• Database: This section deals with functions used with data organized as one row of data for one record.
• Date & Time: These spreadsheet functions are used for inserting and editing dates and times.
• Financial: This category contains the mathematical finance functions of LibreOffice Calc.
• Information: This category contains Information functions.
• Logical: This category contains Logical functions.
• Mathematical: This category contains the Mathematical functions for Calc.
• Array: This category contains the array functions.
• Statistical: This category contains Statistics functions.
• Spreadsheet: This section contains descriptions of the Spreadsheet functions together with an example.
• Text: This section contains descriptions of the Text functions.
• Add-in: The following describes and lists some of the available add-in functions.
हर कैटगरी में करीब 20 से 50 फ़ंक्शन होते हैं. वहीं, कुछ कैटगरी में ज़्यादा फ़ंक्शन होते हैं. ज़्यादातर में सिंटैक्स और एक उदाहरण के साथ कम जानकारी होती है.
मुझे Calc के हर फ़ंक्शन के बारे में ज़्यादा जानकारी देने वाले कॉन्टेंट को जोड़ना है. साथ ही, ODFF स्टैंडर्ड का पालन करने के बारे में बताना है. जहां भी ज़रूरी हो वहां इलस्ट्रेशन और डायग्राम शामिल करने हैं. साथ ही, टिप्पणियों के तौर पर कोने के मामलों और अपवादों को दिखाने के लिए एक या दो उदाहरण देने हैं. इसके अलावा, सैंपल/उदाहरण फ़ाइलें भी उपलब्ध कराने हैं. साथ ही, जहां ज़रूरी हो वहां एक अहम सेक्शन भी जोड़ा जा रहा है. मुझे इन फ़ंक्शन को कैटगरीकल फ़ॉर्मैट में रखना चाहिए. उदाहरण के लिए, किसी एक फ़ंक्शन को चुनना और वर्टिकल फ़ॉर्मैट में काम करते हुए, तकनीकी तौर पर लिखने की अवधि के दौरान अन्य कैटगरी में जाना. इसके अलावा, कम्यूनिटी बॉन्डिंग के दौरान, मैं काम के माहौल के हिसाब से अपने काम को ढालने की कोशिश करूंगी, ताकि लिखने के दौरान मुझे आसानी हो. मेरे अनुभव के मुताबिक, इस तरह के ऐप्लिकेशन के दस्तावेज़ तैयार करते समय, कई बार ""अरे!"" वाली स्थितियों का सामना करना पड़ता है. इन स्थितियों को समझने के लिए, समय देना ज़रूरी है. प्लानिंग के हिसाब से, शुरुआत में मैं इन 11 कैटगरी पर काम करके प्रोजेक्ट पर काम करूंगा. बेशक, कुछ को ज़्यादा मदद की ज़रूरत होगी और इसलिए, दूसरों की तुलना में ज़्यादा समय लगेगा. हालांकि, इन चीज़ों को काम करते समय ठीक किया जा सकता है. कुछ दस्तावेज़ पहले से मौजूद हैं और मैं उन्हें सबसे पहले लिख रहा हूं. इसलिए, हर हफ़्ते का टास्क पूरा होने के बाद, मुझे प्रूफ़रीडिंग की ज़रूरत है, क्योंकि पिछले हफ़्ते के लिए ऐसा नहीं करना चाहिए.
इसलिए, नीचे प्रोजेक्ट को तय समयसीमा में व्यवस्थित करने के लिए एक शुरुआती शेड्यूल दिया गया है.
- पहला हफ़्ता:(14 सितंबर) • डेटाबेस
- दूसरा हफ़्ता:(21 सितंबर) • तारीख और समय
- तीसरा हफ़्ता:(28 सितंबर) • वित्तीय
- चौथा हफ़्ता:(05 अक्टूबर) • जानकारी
- पांचवां हफ़्ता:(12 अक्टूबर) • लॉजिकल
- छठा हफ़्ता:(19 अक्टूबर) • मैथमैटिकल
- सातवां हफ़्ता:(26 अक्टूबर) • ऐरे
- आठवां हफ़्ता:(2 नवंबर) • आंकड़ों से जुड़ी जानकारी
- नौवां हफ़्ता:(9 नवंबर) • स्प्रेडशीट
- 10वां हफ़्ता:(16 नवंबर) • टेक्स्ट
- 11वां हफ़्ता:(23 नवंबर) • ऐड-इन
- 12वां हफ़्ता:(30 नवंबर – 5 दिसंबर)(फ़ाइनल)
इस प्रोजेक्ट में किए गए काम और उससे मिले अनुभव को दस्तावेज़ में दर्ज करना. साथ ही, छोटी-मोटी चीज़ों पर काम करना. इसमें, दस्तावेज़ को सबमिट करने के लिए, ज़रूरत पड़ने पर, दूसरी बार प्रूफ़रीडिंग/बदलाव करना शामिल है.