ऐनी जेंटल, ओपनस्टैक कम्युनिटी डॉक्यूमेंटेशन कोऑर्डिनेटर के साथ साक्षात्कार

हम मिरांटिस ब्लॉग पर ओपनस्टैक परियोजना के तकनीकी प्रबंधकों के साथ साक्षात्कार की श्रृंखला का छठा प्रस्तुत करते हैं। हमारा लक्ष्य तकनीकी विशेषज्ञों के व्यापक समुदाय को शिक्षित करना है और लोगों को यह समझने में मदद करना है कि वे ओपनस्टैक परियोजना से कैसे योगदान कर सकते हैं और लाभ उठा सकते हैं। स्वाभाविक रूप से, साक्षात्कारकर्ता का दृष्टिकोण, और मिरांटिस नीचे नहीं है।

नीचे हम ऐनी जेंटल, ओपनस्टैक कम्युनिटी डॉक्यूमेंटेशन कोऑर्डिनेटर के साथ एक साक्षात्कार प्रस्तुत करते हैं।

मिरान्टिस: हमें अपने बारे में बताओ।

एना जेंटल: मैं रैकस्पेस के लिए काम करता हूं और ओपनस्टैक प्रलेखन लिखता हूं। मैं रैकस्पेस द्वारा विशेष रूप से ओपनस्टैक के साथ काम करने वाला दूसरा कर्मचारी हूं। यह मेरे लिए खुशी का मौका था। 2009 में, मैंने सामुदायिक प्रलेखन पर सहयोग करने के बारे में एक पुस्तक लिखी, और मैंने खुले स्रोत परियोजनाओं के लिए प्रलेखन बनाने में बार-बार भाग लिया है। और इसलिए यह काम दिखाई दिया, मेरे घर के ठीक बगल में, ऑस्टिन (टेक्सास) में, और मैंने इसे पकड़ लिया।

प्रश्न: एक ओपन सोर्स प्रोजेक्ट और क्लोज्ड सोर्स के लिए प्रलेखन के बीच मुख्य अंतर क्या है?

उत्तर: पहला बड़ा अंतर प्रलेखन विकास साधनों से प्रकाशन तक हर चीज में खुला रहने में दिलचस्पी है। काम के पहले सप्ताह में, मुझे यह भी पूछा गया कि क्या हमारे सभी फोंट का उपयोग एक खुले स्रोत के आधार पर किया जाता है! हमारे उपकरण सभी के लिए खुले हैं - आप स्वतंत्र रूप से प्रलेखन लिख सकते हैं या भागों की रचना या पुन: उपयोग कर सकते हैं। दूसरा अंतर प्रलेखन का ही है। एक बंद स्रोत वातावरण में, सेवा स्तर समझौतों या बिलिंग समझौतों के अनुपालन के संदर्भ में प्रलेखन कानूनी आवश्यकताओं द्वारा सीमित है। खुले रूप से, सहयोगात्मक रूप से विकसित दस्तावेजों के पीछे विचार यह है कि कोई भी उन्हें संपादित कर सकता है। साथ ही, कुछ समुदायों में, सामग्री की लेखकता निर्धारित करने में एक निश्चित नैतिकता है। यह क्रिएटिव कॉमन्स लाइसेंस (एट्रिब्यूशन के साथ) के लिए एक अच्छा परिदृश्य है।

परियोजनाओं की एक विस्तृत श्रृंखला है, लेकिन अधिकांश विकल्प सामग्री का उपयोग करने के लिए लाइसेंस और स्वतंत्रता से संबंधित हैं। मेरा यह भी मानना ​​है कि ओपन सोर्स प्रोजेक्ट्स में कई दिलचस्प नवाचार हो रहे हैं। उन्हीं कारणों से जो आप खुले स्रोत के विकास में शामिल हैं, लोग दस्तावेजों के संयुक्त विकास में भाग लेना चाहते हैं।

प्रश्न: खुले तौर पर विकसित दस्तावेजों के बारे में क्या खास है?

उत्तर: प्रलेखन विकसित करते समय, अनुशासन महत्वपूर्ण होता है, और खुले स्रोत का विकास, विचित्र रूप से पर्याप्त, आत्म-संगठित होता है। ऐसी परियोजनाएँ जहाँ दस्तावेज़ किसी कोड से अधिक से अधिक संभव होते हैं, आमतौर पर बहुत अनुशासित होते हैं। आपको प्रलेखन में एक गलती लगती है, और लोग इसे ठीक करने के लिए ले सकते हैं।

समय के साथ, विकी अधिक संगठित हो गए हैं और सामग्री प्रबंधन प्रणालियों में बदल गए हैं, और वार्ड कनिंघम के मूल विचार के आधार पर वास्तविक मुक्त विकी अभी भी सामग्री के साथ काम करने के लिए एक बहुत ही मूल्यवान तंत्र और मूल्यवान विचार है। विकी सिस्टम से अधिक, मुझे अभिनव प्रलेखन विकास सत्र पसंद हैं, जैसे स्प्रिंट तरीके (बुक स्प्रिंट)। मुझे दस्तावेजों को कोड के रूप में मानना ​​भी पसंद है, स्वचालित रूप से उन दस्तावेज़ों को उत्पन्न करने के तरीकों की तलाश में हैं जो उपयोगकर्ताओं की मदद करते हैं और कोड से मेल खाते हैं।

प्रश्न: प्रलेखन के खुले विकास में कौन से सिद्धांत लागू होते हैं?

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

सबसे दिलचस्प तरीकों में से एक बुक स्प्रिंट है। आप लेखकों के एक समूह को इकट्ठा करते हैं, ज्ञान के आदान-प्रदान को व्यवस्थित करते हैं और पूरे सरणी से एक संगठित संरचना को अलग करने की कोशिश करते हैं। हम Booktype टूल का उपयोग करते हैं, और यह बहुत अच्छा है कि Sourcefabric आपके लिए एक उदाहरण का समर्थन कर सकता है।

प्रोसेस गाइड को विकसित करते समय, स्प्रिंट में भाग लेने वाले हर कोई जानता था कि हमारे एक्सएमएल-आधारित उपकरणों का उपयोग कैसे किया जाए, और फिर तुरंत बुकटाइप का उपयोग करने में सक्षम थे, और फिर, स्प्रिंट के बाद, जब सामग्री बस गई और वजन बढ़ा, तो हमने इसे कई टूल में लागू किया। XML आधारित है।

XML- आधारित टूल के बारे में अच्छी बात यह है कि O'Reilly उनका उपयोग करता है। XML का मूल्य यह है कि यह हमें सामग्री के विखंडन का पुन: उपयोग करने, उन्हें टैग करने या फिर से अनुवाद से बचने की अनुमति देता है। सामग्री के टुकड़ों से, आप तब बहुत सारे दस्तावेज़ निकाल सकते हैं। हम चाहें तो ePub प्राप्त कर सकते हैं। और फिर, जैसा कि आप सामग्री के साथ काम करते हैं, आपको पता चलता है कि इस प्रकार का XML- आधारित पार्सिंग, अपारता को समझने और इसे व्यवस्थित करने का सबसे अच्छा तरीका है।

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

मूलभूत सिद्धांतों में से एक यह है कि आप दस्तावेज़ के लिए अपने दृष्टिकोण से नाराज़ या हतोत्साहित नहीं होना चाहते हैं। लोग उन समूहों की तलाश कर रहे हैं जो उनके समान हैं। आप कह सकते हैं: "नहीं, ये मेरे लोग नहीं हैं" या "यह मेरी रुचि का क्षेत्र नहीं है।" मेरे लिए प्रलेखन के खुले विकास के सिद्धांतों में से एक व्यक्तिगत बातचीत है। लोगों को समझना चाहिए कि यह उनका अपना है, कि उनके पास सामान्य लक्ष्य हैं।

मैं काम और योग्यता को सहसंबंधित करने की कोशिश करता हूं ताकि आप निराश न हों और न निकलें। तकनीकी दृष्टिकोण से आपके लिए कौन से कार्य दिलचस्प हैं? मुझे लगता है कि खुले स्रोत के विकास के मूल सिद्धांतों में से एक लोगों और कार्यों का संरेखण है।

प्रश्न: क्या आप लोगों के अनुभव के आधार पर OpenStack प्रलेखन में योगदान में अंतर देखते हैं?

उत्तर: ग्रिजली रिलीज़ के लिए, एपीआई विवरण पुस्तकों के अपवाद के साथ सभी संपादन का 50 प्रतिशत, तीन लोगों द्वारा बनाया गया था, जिसमें मेरे (हंसते हुए) भी शामिल थे। लेकिन हम अधिक से अधिक लोगों को अधिक काम के लिए आकर्षित करने की कोशिश कर रहे हैं।

लेकिन सबसे दिलचस्प यह है कि हमारे कुल 79 प्रोजेक्ट प्रतिभागी थे। इन लोगों ने छह या आठ पैच बनाए, लेकिन उन्हें विशेष ज्ञान भी था। वे जानते थे कि सिंडर को कैसे कॉन्फ़िगर किया जाना चाहिए, क्या किया जाना चाहिए, क्या उद्देश्य था यह महसूस करने के लिए लिखित सामग्री की आवश्यकता होती है।

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

प्रत्येक प्रोजेक्ट के लिए व्यवस्थापकों के लिए निर्देश हैं, लेकिन उन्हें अभी भी सॉफ़्टवेयर स्थापित करने और कॉन्फ़िगर करने के लिए निर्देश होना चाहिए। स्टोरेज गाइड में एक टन जानकारी होती है जो केवल ड्राइवरों के लिए जानी जाती है। यह निर्धारित करना वास्तव में मुश्किल है कि क्या प्रत्येक प्रोजेक्ट के लिए व्यवस्थापक मार्गदर्शिका बनाए रखना आवश्यक है। वर्तमान में, 10 परियोजनाएं और 2 और परियोजनाएं विचाराधीन हैं। हम 10 व्यवस्थापक गाइडों का समर्थन नहीं कर सकते, खासकर यदि उनमें से कुछ आपस में जुड़े हुए हैं। हम अनुसंधान करते हैं और सर्वोत्तम तरीके की तलाश करते हैं) प्रतिभागियों को आकर्षित करते हैं, लेकिन काम के लिए एक परियोजना खोजने में भी उनकी मदद करते हैं।

एक और पहलू है - हम चाहते हैं कि डेवलपर्स डेवलपर्स के लिए लिखें, आदि। बुक स्प्रिंट पद्धति ने मुझे बताया है कि प्रक्रिया गाइड ने काम किया क्योंकि इसके लेखक हर दिन इन प्रक्रियाओं को चलाते हैं। मैं सुरक्षा को मजबूत करने के लिए मैनुअल में एक ही चीज देखता हूं; ये लोग इस विषय पर सांस लेते और जीते हैं।

प्रश्न: लोगों को प्रलेखन में योगदान करने और उसमें भाग लेने से क्या मिलता है?

उत्तर: मुझे लगता है कि बहुत से लोग देखते हैं कि हम GitHub, Gerrit और XML का उपयोग करते हैं और सोचते हैं: "ओह, यह हमारी विशेषता नहीं है!" ... और छोड़ दें। मैंने ऐसे दर्जनों लोगों का परिचय दिया जिन्होंने सदस्य लाइसेंस समझौते (सीएलए) पर हस्ताक्षर किए थे। आपको इसके माध्यम से जाने के लिए पर्याप्त धैर्य होना चाहिए, क्योंकि आप केवल दस्तावेज लिख रहे हैं या एक टाइपो को ठीक करना चाहते हैं, लेकिन आपको सीएलए पर हस्ताक्षर करने की पूरी प्रक्रिया से गुजरना होगा। और मेरा दृढ़ विश्वास है कि यह आवश्यक है। मैं प्रलेखन लेखकों को पसंद करता हूं, जो यादृच्छिक लोगों के बजाय ओपनस्टैक फाउंडेशन और खुले स्रोत समुदाय में शामिल हैं।

और अंत में, ज्ञान और हार्डवेयर और तकनीकी आवश्यकताओं का एक सरल शरीर लोगों को डरा सकता है।

प्रश्न: ओपनस्टैक में प्रलेखन के मामले में मुझे एक शुरुआत से पेशेवर तक किस रास्ते पर जाना चाहिए?

उत्तर: कुछ संभावित तरीके हैं। ओपनस्टैक के साथ काम करने की कोशिश करना सुनिश्चित करें, और फिर देखें कि आपके दर्शक क्या हैं। फिर प्रलेखन को देखकर शुरू करें: “क्या यह मेरे सवालों का जवाब देता है? क्या कोई छूटे हुए टुकड़े हैं? ”और सुनिश्चित करें कि आप दस्तावेज़ पढ़ते समय उपयोगकर्ता या डेवलपर की भूमिका पर प्रयास करें।

मुझे लगता है कि उपयोगकर्ता समूह वास्तव में अच्छी चीजें करना शुरू कर रहे हैं। सीन रॉबर्ट्स और कॉलिन मैकनामारा सैन फ्रांसिस्को बे उपयोगकर्ता समूह के नेता हैं, और वे प्रलेखन लिखने के तरीके पर एक छोटी संगोष्ठी का आयोजन कर रहे हैं क्योंकि ऐसे लोग हैं जो ओपनस्टैक को पकड़ना चाहते हैं, और सीखने का सबसे अच्छा तरीका उपकरण और दस्तावेज सीखना है। और सीखने का एक शानदार तरीका यह रिकॉर्ड करना है कि आप क्या कर रहे हैं।

हमारे पास छात्रों के कई समूह हैं जो कुछ सोचते हैं, "मुझे लगता है कि प्रलेखन एक अच्छा लॉन्चिंग पैड है।" उनके लिए हमारे पास कार्यों की एक सूची है। देखें कि पुस्तक में पृष्ठभूमि की जानकारी है या नहीं। वर्तनी जांच करें। पूंजीकरण नियमों के लिए पाठ की जांच करें, आदि।

मुझे यह भी लगता है कि लोग दस्तावेजों का मूल्यांकन कर सकते हैं। कुछ लोगों ने मुझे संपादन के साथ पीडीएफ भेजा। और यह बिल्कुल सामान्य है। कुछ भी पढ़ना शुरू करना, मूल्यांकन करना, वे चुनना जो वे प्रलेखन के इस विशाल सरणी से निकाल सकते हैं, "ओह, यह वह जगह है जहां मैं शुरू कर सकता हूं।"

प्रश्न: प्रलेखन के लेखकों के लिए प्रशिक्षण शिविर के बारे में बताएं?

उत्तर: हमारा प्रशिक्षण शिविर प्रतिभागियों के बीच संबंधों के निर्माण और अधिक लोगों को प्रलेखन में महत्वपूर्ण भागीदारी के लिए प्रोत्साहित करने का एक तरीका है। हम इसे माउंटेन व्यू, कैलिफोर्निया, 9 सितंबर और 10 वीं में बिताते हैं।

हम सभी साधनों और प्रक्रियाओं से गुजरते हैं ताकि सभी को साधनों में पर्याप्त रूप से महारत हासिल हो। प्रक्रियाओं के लिए, हम इस तरह के सवालों का जवाब देंगे “क्या मुझे इसके लिए एक मसौदा लिखने की आवश्यकता है? या यह सिर्फ एक गलती है? मैं कैसे निर्धारित करूं कि क्या करना है? मैं जांच करने के लिए एक उपकरण कैसे चुनूं? मावेन क्या है? जब मैं एक नई पुस्तक जोड़ता हूं, तो मुझे इसे प्रकाशित करने के लिए क्या करना चाहिए? यदि मैंने कोई परिवर्तन किया है तो मैं कैसे निदान कर सकता हूं, लेकिन मैं इसे साइट पर नहीं देख सकता हूं। ”यह सब पहले दिन है।

और दूसरे दिन, यह एक बातचीत का अधिक हिस्सा है जहां हम इस बारे में बात करते हैं कि हम क्या काम कर सकते हैं। आपको उस दिन सही काम करने के लिए नहीं जाना है, लेकिन कई लोग कहते हैं, "यह वही है जो हम वास्तव में उस ज्ञान के साथ कर सकते हैं जो अब हमें मिला है।" दूसरे दिन, हम प्रलेखन में त्रुटियों को मिटा देते हैं। मुख्य विचार नए सदस्यों के लिए कोर प्रलेखन डेवलपर्स में तुरंत एकीकृत करने के लिए है।

प्रश्न: अनुवाद के बारे में क्या?

उत्तर: मेरे लिए वास्तविक मूल्य है, उदाहरण के लिए, कि एक दिन ओपनस्टैक मैनुअल फ्रेंच में लिखा जाएगा, और अंग्रेजी से फ्रेंच में अनुवाद करने के बजाय, इसका उल्टा अनुवाद होगा। मुझे ऐसा नहीं लगता कि अंग्रेजी को हमेशा स्रोत भाषा के रूप में इस्तेमाल किया जाना चाहिए। यह मेरी निजी राय है, लेकिन यह मुझे नहीं लगता कि ओपनस्टैक के लिए आपका पहला गाइड एक अंग्रेजी मैनुअल होना चाहिए।

प्रलेखन का अनुवाद प्राथमिकता के लिए नीचे आता है। हमारे लिए पहली प्राथमिकता प्रक्रिया मैनुअल का अनुवाद है, क्योंकि यह सबसे बड़ी मांग है। डेज़ी, अनुवाद समन्वयक, ने मुझसे पिछले हफ्ते पूछा कि आगे क्या अनुवाद करना है। और मैंने उत्तर दिया: “ईमानदारी से, मैं इस उपयोगकर्ता गाइड को अनुवादित करना चाहूंगा, संभवतः प्रशासक गाइड के बाद। हम ऑपरेटरों और प्रशासकों के दर्शकों तक उनकी भाषा में पहुंचने का प्रयास करेंगे। ”

प्रश्न: आपके समय के लिए धन्यवाद।

उत्तर: धन्यवाद।