Linux फ़ाउंडेशन प्रोजेक्ट

इस पेज पर, तकनीकी लेखन वाले उस प्रोजेक्ट की जानकारी दी गई है जिसे Google Season of Docs के लिए स्वीकार किया गया है.

प्रोजेक्ट की खास जानकारी

ओपन सोर्स संगठन:
Linux फ़ाउंडेशन
टेक्निकल राइटर:
jaskiratsingh2000
प्रोजेक्ट का नाम:
CHAOSS: CHAOSS कम्यूनिटी के लिए हैंडबुक बनाना
प्रोजेक्ट की अवधि:
स्टैंडर्ड अवधि (तीन महीने)

प्रोजेक्ट का विवरण

प्रोजेक्ट का सारांश:

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

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

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

इसकी ज़रूरत क्यों है?

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

इस हैंडबुक में, समुदाय में शामिल हुए नए सदस्यों को इसकी जानकारी और काम करने का तरीका साफ़ तौर पर बताया गया है. फ़िलहाल, CHAOSS कम्यूनिटी हैंडबुक, GitHub रिपॉज़िटरी में उपलब्ध है. इसमें नए लोगों और कम्यूनिटी के मौजूदा उपयोगकर्ताओं के लिए, ज़्यादा जानकारी शामिल करके उसमें सुधार करने की ज़रूरत है. इसलिए, CHAOSS कम्यूनिटी के लिए बनाई गई यह हैंडबुक, नए और मौजूदा सदस्यों की इन तरीकों से मदद करेगी:

  • CHAOSS कम्यूनिटी की नीतियों को एक ही जगह पर व्यवस्थित करना और उन्हें आधिकारिक तौर पर लागू करना
  • कम्यूनिटी के बारे में जानकारी, मिशन, विज़न, और लीडरशिप के बारे में बताना
  • CHAOSS कम्यूनिटी के तरीकों को समझना
  • योगदान से जुड़े दिशा-निर्देश
  • प्रोजेक्ट के वर्कफ़्लो तय करना
  • CHAOSS कम्यूनिटी के कल्चर के बारे में जानकारी
  • अक्सर पूछे जाने वाले सामान्य सवाल
  • मेंटॉरशिप

प्रोजेक्ट का ब्यौरा:

कम्यूनिटी हैंडबुक को अलग-अलग “सेक्शन” में बांटा जाएगा. इन सेक्शन में, खास विषयों के बारे में सही और ज़्यादा जानकारी होगी. सेक्शन को इन तरीकों से बांटा जा सकता है:

  • परिचय
  • CHAOSS कम्यूनिटी का तरीका
  • Path to Leadership
  • शब्दावली
  • योगदान से जुड़े दिशा-निर्देश
    • डेवलपर
    • डिज़ाइनर
    • राइटर
    • मार्केटर
  • मेट्रिक
  • CHAOSScon
  • CHAOSScast
  • मीटिंग के वीडियो
  • अक्सर पूछे जाने वाले सामान्य सवाल
  • मेंटॉरशिप
    • Google Summer of Code
    • Outreachy
    • Google Season of Docs

प्रोजेक्ट के डिलीवर किए जाने वाले आइटम की ज़्यादा जानकारी

1.) परिचय:

यह सेक्शन, CHAOSS कम्यूनिटी हैंडबुक के पहले पेज की तरह काम करेगा. इसमें हैंडबुक की जानकारी, उसकी खास जानकारी, और उसके इस्तेमाल के बारे में बताया जाएगा. यहां इन चीज़ों के बारे में बताया गया है:

A.) इसमें वेलकम मैसेज के साथ-साथ, CHAOSS कम्यूनिटी के बारे में कम शब्दों में जानकारी दी गई होगी. इससे पाठकों को हैंडबुक पढ़ने में मदद मिलेगी. हम यहां से ली गई इमेज का कोलाज भी शामिल करेंगे https://chaoss.community/chaoss-photo-album/. इससे कम्यूनिटी में होने वाली अलग-अलग गतिविधियों के बारे में जानकारी मिलेगी. B.) इस पेज पर सभी सेक्शन की जानकारी होगी. साथ ही, हर सेक्शन और सही लिंक के बारे में एक लाइन में बताया जाएगा. C.) हैंडबुक का इस्तेमाल: हैंडबुक के इस्तेमाल की जानकारी यहां पहले से मौजूद है( shorturl.at/cqQU6 ) पर. हालांकि, मैं मौजूदा हैंडबुक के इस्तेमाल में बदलाव करके उसे बेहतर मार्कडाउन के ज़रिए बदलूँगा. इसमें हैंडबुक का फ़्लो शामिल होगा(इसमें यह शामिल किया जाएगा कि जब कोई व्यक्ति हैंडबुक से जुड़ी चीज़ों को जोड़ना, हटाना या इस पर चर्चा करना चाहे, तो कैसे होता है. यह हैंडबुक से जुड़ी किसी भी चीज़ के लिए, संपर्क करने के तरीके की प्रोसेस का पालन कर सकता है.), हैंडबुक के दिशा-निर्देश(इसमें कम्यूनिटी और दायरे में इसका इस्तेमाल शामिल है), हैंडबुक में योगदान ( इसमें यह शामिल है कि बदलाव करने के लिए, किसी को रेपो का इस्तेमाल कैसे करना चाहिए, पीआर कैसे बनाना चाहिए, हैंडबुक और स्टाइल गाइड में बदलाव करने के लिए किस टेंप्लेट का इस्तेमाल करना चाहिए) और हैंडबुक के बारे में सुझाव, शिकायत या राय शेयर करना. 'सुझाव शेयर करना' में, मैं एक टेंप्लेट और अलग-अलग तरीके शामिल करूंगा/करूंगी, जिनका पालन करके उपयोगकर्ता इसे पाने के लिए GitLab की समस्याएं दे सकेंगे या उनका इस्तेमाल कर सकेंगे.

2.) CHAOSS कम्यूनिटी का तरीका:

CHAOSS की कम्यूनिटी बनाने का तरीका, लोगों के लिए कम्यूनिटी के तौर-तरीकों और दिशा-निर्देशों को समझने के लिए अहम होगा. वर्कफ़्लो की मदद से, कॉन्टेंट पर ज़्यादा ध्यान दिया जा सकेगा और कम्यूनिटी के तौर-तरीकों के बारे में सबसे सही तरीके से बताया जा सकेगा. इस सेक्शन में ये चीज़ें शामिल हैं:

A.) सामान्य वैल्यू: इसमें बताया गया है कि CHAOSS कम्यूनिटी में, टिकाऊपन, खुलापन, और पारदर्शिता को कैसे मैनेज किया जाता है. हम इन वैल्यू के बारे में बताएंगे कि नए उपयोगकर्ता या मौजूदा उपयोगकर्ताओं को इसे कैसे समझना चाहिए और कम्यूनिटी के साथ काम करते समय इसे ध्यान में कैसे रखना चाहिए. B.) कम्यूनिटी दिशा-निर्देश: इसमें बताया गया है कि CHAOSS कम्यूनिटी में शामिल होने और बुनियादी शर्तों का पालन करने का सही तरीका क्या है. इससे यह भी पता चलेगा कि कम्यूनिटी में काम करने का तरीका क्या है. (क्या करें और क्या न करें). इसमें योगदान देने वालों/रखरखाव करने वालों की मुख्य चेकलिस्ट शामिल होगी. साथ ही, उन्हें दूसरों को यह भी बताया जाएगा कि उन्हें रखरखाव करने वाले लोगों के साथ कैसे काम करना चाहिए और उनकी चेकलिस्ट क्या है. C.) वर्किंग ग्रुप: इस पेज( https://chaoss.community/participate/ ) पर वर्किंग ग्रुप के बारे में जानकारी दी गई है. जैसे, वर्किंग ग्रुप के बारे में जानकारी, रिपॉज़िटरी का लिंक, और मीटिंग की जानकारी. हालांकि, हैंडबुक में मैं अलग-अलग वर्किंग ग्रुप में हिस्सा लेने का तरीका बताऊंगा. साथ ही, मेट्रिक का आकलन करने की प्रोसेस, संबंधित वर्किंग ग्रुप के काम करने के तरीके, और अलग-अलग वर्किंग ग्रुप के मुख्य योगदानकर्ता बनने का तरीका भी बताऊंगा.

3.) लीडरशिप का पाथ:

एक ओपन-सोर्स प्रोजेक्ट में लीडरशिप हासिल करना, व्यावसायिक दुनिया में किसी समुदाय की खुद की सफलता के लिए ज़रूरी हो सकता है. इसलिए, इन बातों को ध्यान में रखते हुए, मैं इन चीज़ों को शामिल करूंगा:

A.) तकनीकी लीडरशिप: इसमें, डेटा को मैनेज करने वाले, दस्तावेज़ लिखने वाले, और वेबसाइट को मैनेज करने वाले लोगों की प्रोसेस और ज़िम्मेदारियां शामिल होंगी B.) गवर्नेेंस लीडरशिप: इसमें बोर्ड के सदस्य और फ़ैसला लेने वाले लोगों के पाथवे शामिल होंगे C.) ऑपरेशनल लीडरशिप: इसमें कम्यूनिटी मैनेजर के लिए पाथवे शामिल होगा

4.) शब्दावली:

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

5.) योगदान देने से जुड़े दिशा-निर्देश:

यह किसी भी ओपन सोर्स कम्यूनिटी के लिए मुख्य संदर्भ है, क्योंकि ज़्यादातर ओपन सोर्स कम्यूनिटी, योगदान या वॉलंटियर के काम पर निर्भर करती हैं. इससे, कम्यूनिटी में शामिल होने वाले किसी भी नए व्यक्ति/उपयोगकर्ता को, बुनियादी ज़रूरतों और उन दिशा-निर्देशों को समझने में मदद मिलेगी जिनका उन्हें पालन करना होगा. इसलिए, इसमें यह जानकारी शामिल होगी:

A.) कम्यूनिटी के रोडमैप को समझना: इस विषय में, CHAOSS कम्यूनिटी के रोडमैप की खास जानकारी दी गई है. इससे उपयोगकर्ताओं को यह जानने में मदद मिलेगी कि CHAOSS प्रोजेक्ट में अलग-अलग कामों को प्राथमिकता देने के लिए, किस तरीके या प्रोसेस का पालन करना है. B.) डेवलपमेंट, दस्तावेज़ तैयार करना, डिज़ाइन करना, टेस्टिंग वगैरह जैसे किसी भी काम में योगदान देने के लिए ज़रूरी चीज़ों के बारे में बताना C.) GitLab के काम करने के तरीके के बारे में खास जानकारी देना D.) समीक्षकों/रखरखाव करने वालों के लिए गाइड

इस सेक्शन में, योगदान की हर कैटगरी के लिए “भूमिकाएं और ज़िम्मेदारियां” भी शामिल होंगी. ये कैटगरी यहां दी गई हैं:

a.) डिज़ाइन: इस सबसेक्शन में “CHAOSS डिज़ाइन वर्कफ़्लो” और डिज़ाइन के दिशा-निर्देश शामिल होंगे. इनमें डिज़ाइन के सिद्धांत, प्रोसेस, और इस्तेमाल किए गए टूल शामिल होंगे. डिज़ाइन फ़ील्ड में योगदान देने के लिए, योगदान देने वालों को इनका पालन करना होगा. b.) डेवलपमेंट: इसमें कोडबेस में योगदान देने के लिए गाइड शामिल होगी. इसमें तकनीकी ज़रूरी शर्तें, प्रोजेक्ट का स्ट्रक्चर, प्रोजेक्ट सेटअप(Augur, Cregit, GremoireLab) वगैरह शामिल होंगे दस्तावेज़: इसमें दस्तावेज़ के लिए संसाधन शामिल होंगे. जैसे, टूल और स्टाइल गाइड. d.) पहुंच: इसमें यह बताया जाएगा कि योगदान देने वाले लोग, CHAOSS कम्यूनिटी की पहुंच बढ़ाने में कैसे मदद कर सकते हैं. जैसे, ब्लॉग लिखना, सोशल हैंडल का इस्तेमाल करना, मीटिंग और इवेंट का आयोजन करना

6.) मेट्रिक

फ़िलहाल, CHAOSS कम्यूनिटी वेबसाइट पर मेट्रिक रिलीज़( https://chaoss.community/metrics/ ) की जानकारी मौजूद है. लोगों के लिए यह समझना ज़्यादा ज़रूरी है कि अपनी मेट्रिक वेबसाइट को उस वेबसाइट पर उपलब्ध कराने के लिए, प्रोसेस को कैसे पूरा किया जाए. इसलिए, यह सेक्शन उपयोगकर्ताओं को वह जानकारी देगा जिससे उपयोगकर्ताओं को प्रोसेस के बारे में जानने और अपनी मेट्रिक रिलीज़ करने के लिए काम करने में मदद मिलेगी.

7.) CHAOSScon:

CHAOSScon के बारे में जानकारी, GitHub( https://github.com/chaoss/governance/blob/master/community-handbook/chaosscon.md ) और वेबसाइट( https://chaoss.community/CHAOSScon-2020-NA/ ) पर पहले से मौजूद है. हालांकि, हैंडबुक में CHAOSScon की प्रोसेस और उसे मैनेज करने के तरीकों के बारे में जानकारी जोड़ना ज़्यादा सही रहेगा. हैंडबुक में यह जानकारी शामिल होगी:

A.) ऑर्गनाइज़िंग कमिटी के बारे में जानकारी: इसमें CHAOSScon के ऑर्गनाइज़िंग कमिटी में शामिल होने के तरीके के बारे में बताया जाएगा B.) कॉल फ़ॉर प्रपोज़ल प्रोसेस मैनेज करना: इसमें लेखक के रजिस्ट्रेशन को मैनेज करना, प्रस्ताव और दस्तावेज़ सबमिट करना, समीक्षा करना, और मंज़ूरी की प्रोसेस शामिल होगी. C.) CHAOSScon प्रोग्राम को मैनेज और पब्लिश करना डी.) विज्ञापन और मार्केटिंग से जुड़ी चीज़ों को मैनेज करने का तरीका E.) प्रायोजन के प्रस्तावों और पैसों को मैनेज करने का तरीका. इसमें पैकेज भी शामिल हैं

8.) चेओस्कास्ट:

CHAOSScast की जानकारी यहां मौजूद है https://github.com/chaoss/governance/blob/master/community-handbook/chaosscast.md. इसे हैंडबुक में शामिल किया जाएगा. इसमें कुछ और जानकारी भी शामिल होगी, जैसे कि हिस्सा लेने वाले लोग, आयोजन समिति, विज्ञापन, और मार्केटिंग के लिए कॉन्टेंट.

9.) मीटिंग के वीडियो:

इसमें मीटिंग के सभी वीडियो के साथ-साथ, मीटिंग में शामिल लोगों, एजेंडा वगैरह की जानकारी भी शामिल होगी. ये वीडियो, पहले की गई और YouTube पर उपलब्ध मीटिंग के होंगे.

10.) अक्सर पूछे जाने वाले सामान्य सवाल:

इनमें कम्यूनिटी में अक्सर पूछे जाने वाले सामान्य सवाल शामिल होंगे. इससे नए लोगों और कम्यूनिटी के मौजूदा सदस्यों को, इनमें से कुछ सवालों के जवाब देने में मदद मिलेगी.

11.) Google Summer of Code:

इस सेक्शन में, Google Summer of Code, ज़रूरी शर्तों, और CHAOSS कम्यूनिटी के तहत Google Summer of Code में हिस्सा लेने के तरीके के बारे में जानकारी होगी. इस सेक्शन में, प्रस्ताव का टेंप्लेट भी शामिल होगा. इसका इस्तेमाल करके, लोग अपने प्रस्ताव और भूमिकाओं और ज़िम्मेदारियों का ड्राफ़्ट तैयार कर सकते हैं. इसके अलावा, इसमें ऐसी जानकारी भी शामिल होगी जिससे कम्यूनिटी के मौजूदा सदस्यों को संगठन के एडमिन और मेंटर बनने की प्रोसेस के बारे में जानने में मदद मिलेगी.

  1. Outreachy:

इस सेक्शन में, Outreachy और ज़रूरी शर्तों के बारे में जानकारी होगी. साथ ही, Outreachy में CHAOSS कम्यूनिटी के तहत लोगों के हिस्सा लेने के तरीके के बारे में जानकारी होगी. इसमें भूमिकाएं और ज़िम्मेदारियां शामिल होंगी. जैसे, संगठन के एडमिन और मेंटर बनने की प्रोसेस.

  1. Google Season of Docs:

इस सेक्शन में आपको GSoD और इसकी ज़रूरी शर्तों के बारे में जानकारी मिलेगी. साथ ही, यह जानकारी भी होगी कि GSoD में CHAOSS कम्यूनिटी में लोग कैसे हिस्सा ले सकते हैं. इसमें भूमिकाएं और ज़िम्मेदारियां शामिल होंगी. जैसे, संगठन के एडमिन और मेंटर बनने की प्रोसेस.

प्रोजेक्ट का अनुमानित नतीजा:

किसी भी कम्यूनिटी में हैंडबुक की अहम भूमिका होती है. इसी तरह, CHAOSS समुदाय के लोगों की इस हैंडबुक से, CHAOSS समुदाय के लिए बेहतर तरीके से व्यवस्थित और ज़्यादा जानकारी वाले दस्तावेज़ तैयार होंगे. इससे, समुदाय में शामिल होने वाले नए लोगों के साथ-साथ मौजूदा सदस्यों के लिए भी, CHAOSS कम्यूनिटी के बुनियादी सिद्धांतों और काम करने के तरीके को समझना आसान हो जाएगा. इसके अलावा, इस हैंडबुक का इस्तेमाल करने पर, CHAOSS समुदाय के लोगों में अलग-अलग काम करने की संस्कृति के लिए अलग-अलग प्रक्रियाएं और रास्ते शामिल होंगे.

तकनीकी जानकारी:

हमारा सुझाव है कि हैंडबुक को मैनेज करने के लिए, Gitbook प्लैटफ़ॉर्म का इस्तेमाल करें. यह उपयोगकर्ता के लिए आसान है और टीम के साथ मिलकर काम करने में मदद करता है. इससे टीमें ज़्यादा असरदार और बेहतर तरीके से काम कर सकती हैं. GitBook प्लैटफ़ॉर्म की कुछ सुविधाएं:

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

यहां कुछ इमेज दी गई हैं जिनसे प्लैटफ़ॉर्म की झलक मिलती है

  • shorturl.at/GNQR4
  • shorturl.at/gATZ8
  • shorturl.at/qrE57
  • shorturl.at/rFRX6
  • shorturl.at/eyLW1
  • shorturl.at/rwHS8

-- हैंडबुक को कहां होस्ट किया जाएगा?

हैंडबुक को GitBook पर होस्ट किया जाएगा. यहां GitHub, कस्टम डोमेन, सामान्य गड़बड़ी, और एसईओ के लिए सही तरीका उपलब्ध कराता है.

कस्टम डोमेन: अगर CHAOSS समुदाय उसे कस्टम डोमेन पर होस्ट करना चाहता है, तो वह इस docs.chaoss.community की तरह दिखेगा. संगठन को सिर्फ़ अपनी पसंद का सबडोमेन बनाना होगा. संगठन का डोमेन सेट अप करने के लिए, Gitbook प्लैटफ़ॉर्म पर संगठन की सेटिंग पर जाएं. इमेज का उदाहरण: shorturl.at/GNQR4

GitBook स्पेस, हमारे सीडीएन पर दिखाए जाते हैं. इनमें एचटीटीपीएस डिफ़ॉल्ट रूप से चालू होता है. ये सर्टिफ़िकेट, LetsEncrypt ने जारी किए हैं

इन डोमेन के लिए काम करता है:

  • उप डोमेन: www.example.com
  • कस्टम डोमेन: docs.example.com

-- Gitbook को GitHub के साथ कैसे सिंक करें, ताकि दोनों प्लैटफ़ॉर्म पर बेहतर तरीके से बदलाव किया जा सके?

GitHub के साथ इंटिग्रेशन का इस्तेमाल करना बहुत आसान है: अगर कोई व्यक्ति GitBook पर किसी कॉन्टेंट में बदलाव करता है, तो उसके बदलावों को GitHub डेटा स्टोर करने की जगह पर भेज दिया जाता है. इसके उलट, GitHub रिपॉज़िटरी में पुश किए गए कमिट, GitBook में इंपोर्ट किए जाते हैं.

GitHub इंटिग्रेशन सेटअप करना:

  • GitBook प्लैटफ़ॉर्म में अपने स्पेस में, इंटिग्रेशन टैब > GitHub पर क्लिक करें
  • GitBook को अपने संगठन से जुड़े GitHub खाते को ऐक्सेस करने की अनुमति देना
  • अपने संगठन के GitHub खाते पर जाएं और “हैंडबुक” के लिए एक रेपो बनाएं. उदाहरण के लिए, chaoss-handbook
  • अब GitBook प्लैटफ़ॉर्म में अनुमति देने के विकल्प में, chaoss-handbook नाम का वह रिपॉज़िटरी चुनें जिसे आपको कनेक्ट करना है.

इन सभी चरणों को पूरा करने के बाद GitBook, अव्यवस्थित हैंडबुक को स्टोर करने की जगह में एक वेबहुक जोड़ देगा. इससे यह डेटा स्टोर करने की जगह में किए गए हर बदलाव का कॉन्टेंट फ़ेच कर सकेगा. GitBook में बदलाव करने पर, एक नई टिप्पणी पॉइंट की जाएगी.

बस इतना ही! कोई भी व्यक्ति GitBook या GitHub रिपॉज़िटरी से बदलाव करना जारी रख सकता है.

-- GitBook प्लैटफ़ॉर्म पर पेजों में बदलाव कैसे करें?

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

ड्राफ़्ट, उपयोगकर्ता के कॉन्टेंट का ऐसा वर्शन होता है जिसमें बदलाव किया जा सकता है. इसे सिर्फ़ लेखक ऐक्सेस कर सकते हैं. लिखना शुरू करने पर, ड्राफ़्ट अपने-आप बन जाता है. जैसे, एडिटर में पहला अक्षर डालना, नया पेज बनाना, कोई फ़ोटो अपलोड करना वगैरह.

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

ड्राफ़्ट का पहला वर्शन, हमेशा तुरंत पब्लिश करने के लिए तैयार नहीं होता. अगर आप अपना काम बाद में जारी रखना चाहते हैं या आपकी सामग्री अभी तक “मर्ज” करने के लिए तैयार नहीं है, तो ""सेव करें"" का इस्तेमाल करें.

बदलाव करने के बाद, अपने ड्राफ़्ट को ""मर्ज"" किया जा सकता है. इसके बाद, आपका लिखा कॉन्टेंट या किए गए बदलाव, आपकी टीम के सदस्यों के लिए उपलब्ध हो जाएंगे और/या सार्वजनिक हो जाएंगे.

इमेज के उदाहरण: shorturl.at/gATZ8 और shorturl.at/qrE57

-- कॉन्टेंट का स्ट्रक्चर:

विषय सूची: हर स्पेस में उतने पेज हो सकते हैं जितने आपके दस्तावेज़ को लिखने के लिए ज़रूरी हैं. ये सभी पेज आपकी स्क्रीन पर बाईं ओर ही दिखते हैं. इन पेजों को 'कॉन्टेंट की टेबल' कहा जाता है. कॉन्टेंट की टेबल से, अपने पेजों को मैनेज किया जा सकता है: नए पेज बनाएं, पेजों का ग्रुप बनाएं, बाहरी लिंक जोड़ें, वैरिएंट जोड़ें, वेबसाइटों या Markdown (.md या .markdown), एचटीएमएल (.html), Microsoft Word (.docx) फ़ाइलों जैसे बाहरी दस्तावेज़ इंपोर्ट करें.

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

पेज: एडिटर में सबसे ऊपर, पेज का टाइटल और जानकारी होती है. जानकारी देना ज़रूरी नहीं है. इसके बाद, उसमें कोई भी कॉन्टेंट लिखा और जोड़ा जा सकता है.‌ पेजों को नेस्ट करने के लिए, किसी पेज को खींचकर दूसरे पेज के नीचे छोड़ें. पेज के चिल्ड्रन छिपा दिए जाएंगे, लेकिन इसे छोटा किया जा सकता है.

बाहरी लिंक: ये एंट्री बाहरी लिंक हैं और एडिटर में कोई कॉन्टेंट नहीं है. इनका मुख्य फ़ंक्शन, बाहरी वेबसाइटों से लिंक करना है.

वैरिएंट: वैरिएंट बनाकर, अपने दस्तावेज़ के लिए कोई दूसरा कॉन्टेंट बनाया जा सकता है. यह किसी एपीआई, लाइब्रेरी या अनुवाद के कई वर्शन को दस्तावेज़ में शामिल करने के लिए मददगार हो सकता है.

इमेज का उदाहरण: shorturl.at/eyLW1 और shorturl.at/rFRX6

-- हैंडबुक को क्लाइंट-साइड पर कैसे दिखाया जाएगा?

Chaoss कम्यूनिटी हैंडबुक को सबडोमेन के साथ ऐक्सेस किया जा सकेगा जो https://docs.chaoss.community हो सकता है और यह उपयोगकर्ता की ओर से नीचे दिए गए तरीकों से दिखेगा:

  • Mattermost हैंडबुक - https://handbook.mattermost.com/
  • Linux फ़ाउंडेशन कम्यूनिटी ब्रिज दस्तावेज़ - https://docs.linuxfoundation.org/docs/ वगैरह

प्रोजेक्ट की टाइमलाइन:

1.) कम्यूनिटी बॉन्डिंग फ़ेज़ (17 अगस्त से 13 सितंबर)

A.) पहला से चौथा हफ़्ता:

  • प्रोजेक्ट के बारे में मेंटर से बातचीत करना
  • प्रोजेक्ट के अलग-अलग सेक्शन के लिए ज़रूरी जानकारी पर रिसर्च करें और उसे इकट्ठा करें. साथ ही, समुदाय से साफ़ तौर पर सवाल पूछें
  • समुदाय को साफ़ तौर पर बताएं कि हैंडबुक के लिए कौनसा प्लैटफ़ॉर्म इस्तेमाल करना चाहिए (मेरा सुझाव है कि आपका GitBook) और उसे सेट अप करें
  • दस्तावेज़ों से जुड़ी समस्याओं को हल करने में मदद करना

2.) दस्तावेज़ बनाने का फ़ेज़ (14 सितंबर से 30 नवंबर)

A.) पांचवां हफ़्ता (14 सितंबर से 20 सितंबर)

  • ड्राफ़्ट” का इंट्रो सेक्शन

B.) छठा हफ़्ता (21 सितंबर से 27 सितंबर)

  • “CHAOSS कम्यूनिटी का तरीका” सेक्शन का ड्राफ़्ट

C.) सातवां हफ़्ता (28 सितंबर से 4 अक्टूबर)

  • “लीडरशिप का पाथ” सेक्शन का ड्राफ़्ट तैयार करना
  • “शब्दावली” सेक्शन का ड्राफ़्ट तैयार करना

D.) हफ़्ता 8 (5 अक्टूबर से 11 अक्टूबर)

  • कम्यूनिटी का रोडमैप तैयार करना
  • ड्राफ़्ट डिज़ाइन में योगदान के लिए दिशा-निर्देश

E.) नौवां हफ़्ता (12 अक्टूबर - 18 अक्टूबर)

  • ड्राफ़्ट डेवलपमेंट सेक्शन

F.) 10वां हफ़्ता (19 अक्टूबर से 25 अक्टूबर)

  • लेखन और आउटरीच सेक्शन के दिशा-निर्देश

जी॰) 11वां हफ़्ता (26 अक्टूबर से 1 नवंबर)

  • ड्राफ़्ट मेट्रिक सेक्शन
  • ड्राफ़्ट CHAOSScon सेक्शन

H.) 12वां हफ़्ता (2 नवंबर - 8 नवंबर)

  • मीटिंग सेक्शन डिज़ाइन करें

  • कम्यूनिटी के बारे में अक्सर पूछे जाने वाले सामान्य सवालों का ड्राफ़्ट तैयार करें

    I.) 13वां हफ़्ता (9 नवंबर से 15 नवंबर)

  • GSOC के दिशा-निर्देशों के बारे में ड्राफ़्ट

J.) चौदहवां हफ़्ता (16 नवंबर से 22 नवंबर)

  • Outreachy के दिशा-निर्देशों के बारे में ड्राफ़्ट

K.) 15वां हफ़्ता (23 नवंबर से 29 नवंबर)

  • बफ़र टाइम, दस्तावेज़ों को बेहतर बनाना और बेहतर बनाना

3.) इवैलुएशन का फ़ेज़ (30 नवंबर से 5 दिसंबर)

A.) 16वां हफ़्ता:

  • प्रोजेक्ट रिपोर्ट का ड्राफ़्ट तैयार करना
  • प्रोजेक्ट के लिए, इवैलुएशन फ़ॉर्म भरना

कम्यूनिटी के साथ इंटरैक्शन

1.) कम्यूनिटी से जुड़ना और उससे चर्चा करना.

मैं अप्रैल 2020 से सीएचएओएस समुदाय में सर्फ़ कर रहा हूं. साथ ही, समुदाय के सदस्यों और प्रोजेक्ट में काम करने वाले अपने खास मेंटॉर( जॉर्ग लिंक और आर्मस्ट्रॉन्ग फ़ाउंडजेम) के साथ अलग-अलग चर्चाओं में शामिल हूं. कम्यूनिटी के सदस्यों की दिलचस्पी बढ़ाने वाली एक बातचीत, “कम्यूनिटी हैंडबुक को होस्ट करने के लिए Gitbook को प्लैटफ़ॉर्म के तौर पर इस्तेमाल करने का सुझाव” थी. इस बातचीत को CHAOSS के संग्रह वाले मेलिंग सूची के थ्रेड में देखा जा सकता है. इस थ्रेड का नाम, कम्यूनिटी हैंडबुक को होस्ट करने के लिए Gitbook को प्लैटफ़ॉर्म के तौर पर इस्तेमाल करने का सुझाव है. मैं हर हफ़्ते होने वाले कम्यूनिटी कॉल में भी हिस्सा लेती हूं. इससे मुझे कम्यूनिटी को अपडेट देने में मदद मिलती है.

2.) इस प्रोजेक्ट के लिए ज़रूरी जानकारी कैसे इकट्ठा की जाएगी?

इस प्रोजेक्ट के लिए, पूरे समुदाय के लिए हैंडबुक सेट अप करना ज़रूरी है. इससे, इसमें मौजूद जिस जानकारी को ऐक्सेस करना है उसे इकट्ठा किया जाएगा और उसके सदस्यों के साथ चर्चा की जाएगी. मैंने ऊपर अपनी टाइमलाइन का सुझाव दिया है. इसके मुताबिक, कम्यूनिटी बॉन्डिंग के दौरान, मैं ज़रूरी जानकारी इकट्ठा कर पाऊंगा और उस पर चर्चा कर पाऊंगा.

मैं CHAOSS के मुताबिक अलग-अलग सेक्शन पर रिसर्च करूंगा और ईमेल पाने वाले लोगों की सूची में मौजूद थ्रेड को जारी रखूंगा. मैं ज़रूरी शर्तों के हिसाब से, अपने मेंटॉर और कम्यूनिटी से साफ़ तौर पर सवाल पूछने की कोशिश करूंगा.

कम शब्दों में बातचीत करने के लिए, मैं हर हफ़्ते होने वाले कॉल में भी शामिल रहूंगा.

3.) आपने यह कैसे सोचा होगा कि कम्यूनिटी को आपकी प्रोग्रेस के बारे में कैसे बताया जाएगा. साथ ही, प्रोजेक्ट के दौरान आपकी क्या समस्याएं या सवाल होंगे, यह भी बताएं?

अपने सवालों के जवाब पाने के लिए, मैं मेलिंग सूची की चर्चा में शामिल होने की कोशिश करूंगा, ताकि पारदर्शिता बनी रहे और मुझे आसानी से जवाब मिल सकें.

मैं एक ब्लॉग पोस्ट के तौर पर, अपनी हर हफ़्ते की प्रोग्रेस शेयर करूंगा/करूंगी. इसमें स्क्रम दस्तावेज़ और उनके सामने आने वाली चुनौतियां शामिल होंगी. इन्हें कम्यूनिटी ईमेल पाने वाले लोगों की सूची में शामिल किया जाएगा, ताकि ओपन-सोर्स संगठन के बड़े लोगों तक पहुंचा जा सके.

मैं हर हफ़्ते कम्यूनिटी कॉल में भी शामिल रहूंगा, ताकि मुख्य समस्याओं के बारे में सही सुझाव और चर्चा की जा सके.

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

4.) अगर आपको अपने प्रोजेक्ट में कोई समस्या आती है और आपका मेंटॉर नहीं है, तो आपको क्या करना चाहिए?

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

हालांकि, अगर मुझे मदद चाहिए और उस समय मेंटर उपलब्ध नहीं है या व्यस्त है, तो मैं CHAOSS कम्यूनिटी में अपनी समस्या शेयर करूंगा. मुझे यकीन है कि मुझे किसी भी तरह की चुनौती का सामना करने में कोई न कोई ज़रूर मदद करेगा. हम इस समस्या को dev.to जैसे ऑनलाइन फ़ोरम/डेवलपर कम्यूनिटी पर भी शेयर करेंगे

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