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

इस पेज पर Google Docs के सीज़न के लिए स्वीकार किए गए एक तकनीकी लेखन प्रोजेक्ट की जानकारी है.

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

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

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

प्रोजेक्ट की वजह:

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

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

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

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

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

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

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

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

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

  • शुरुआती जानकारी
  • CHAOSS कम्यूनिटी का तरीका
  • लीडरशिप की दिशा
  • शब्दावली
  • योगदान के लिए दिशा-निर्देश
    • डेवलपर
    • Designer
    • राइटर
    • मार्केटर
  • मेट्रिक
  • CHAOSScon
  • CHAOSScast
  • मीटिंग के वीडियो
  • अक्सर पूछे जाने वाले सामान्य सवाल
  • मेंटॉरशिप
    • Google का कोड ऑफ़ कोड
    • आउटरीच
    • Docs का Google सीज़न

मिटाए गए प्रोजेक्ट की पूरी जानकारी

1.) परिचय:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

6.) मेट्रिक

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

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:

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

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

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

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

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

11.) Google का कोड ऑफ़ कोड:

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

  1. आउटरीच:

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

  1. Docs का Google सीज़न:

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

प्रोजेक्ट के लिए अनुमानित तौर पर यह उम्मीद नहीं की जा सकती:

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

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

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

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

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

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

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

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

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

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

इस्तेमाल किए जा सकने वाले डोमेन:

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

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

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

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

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

इन चरणों के पूरा होने के बाद, 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 हो सकती है. यह उपयोगकर्ता के लिए इस तरह दिखेगी:

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

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

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

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

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

2.) दस्तावेज़ डेवलपमेंट फ़ेज़ (14 सितंबर से 30 नवंबर)

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

  • ड्राफ़्ट” परिचय सेक्शन

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

  • “The CHAOSS कम्यूनिटी वे” सेक्शन का ड्राफ़्ट बनाएं

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

  • “नेतृत्व का रास्ता” सेक्शन का ड्राफ़्ट तैयार करें
  • “शब्दावली” सेक्शन को ड्राफ़्ट करें

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

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

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

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

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

  • लिखने और संपर्क करने की सुविधा वाले सेक्शन के लिए दिशा-निर्देश

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

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

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

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

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

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

  • जीएसओसी के दिशा-निर्देशों के बारे में ड्राफ़्ट

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

  • आउटरीच दिशा-निर्देशों के बारे में ड्राफ़्ट

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

  • बफ़र टाइम; पूरे दस्तावेज़ को पॉलिश और बेहतर करने की सुविधा

3.) मूल्यांकन का चरण (30 नवंबर से 5 दिसंबर)

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

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

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

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

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

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

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

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

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

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

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

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

मुख्य मुद्दों पर सही सुझाव देने और चर्चा करने के लिए, मुझे हर हफ़्ते होने वाले कम्यूनिटी कॉल में भी शामिल होना है.

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

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

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

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

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