मर्ज हुए पुल रिक्वेस्ट से प्रकाशित चेंजलॉग तक
Okou इस हफ़्ते मर्ज हुए पुल रिक्वेस्ट पढ़ता है, उपयोगकर्ता से जुड़े बदलाव चुनता है, चेंजलॉग पोस्ट लिखता है और आपकी मंज़ूरी मिलते ही उसी रन में उसे ब्लॉग, आपकी Resend सूची और X पर प्रकाशित कर देता है।
चेंजलॉग ऑटोमेशन क्या है?
चेंजलॉग ऑटोमेशन का मतलब है कि हफ़्ते के अंत में याददाश्त के भरोसे लिखने के बजाय, आपकी टीम ने असल में जो मर्ज किया उसी से प्रोडक्ट अपडेट तैयार हो। Okou बीच का एजेंट बनता है: वह GitHub में मर्ज हुए पुल रिक्वेस्ट पढ़ता है, उपयोगकर्ता से जुड़े बदलाव रखता है, उन्हें थीम में समूहित करता है, चेंजलॉग पोस्ट लिखता है और एक ही रन में उसे ब्लॉग, Resend न्यूज़लेटर तथा X थ्रेड पर प्रकाशित करता है। नतीजा एक साप्ताहिक प्रोडक्ट अपडेट है जो समय पर निकलता है और हर चैनल पर एक ही बात कहता है।
साप्ताहिक चेंजलॉग पूरा शुक्रवार क्यों खा जाता है
शुक्रवार दोपहर। इस हफ़्ते तीस के आसपास पुल रिक्वेस्ट मर्ज हुए हैं और किसी को उन्हें ऐसा अपडेट बनाना है जिसे लोग सचमुच पढ़ें। आप मर्ज की सूची पर नज़र दौड़ाते हैं, अंदाज़ा लगाते हैं कि कौन-से बदलाव उपयोगकर्ता से जुड़े हैं, पोस्ट लिखते हैं, ईमेल के लिए छोटा करते हैं, X के लिए और छोटा करते हैं, फिर हर संस्करण को अलग-अलग टूल में चिपकाते हैं। यह वही पढ़ाई तीन बार है, और X पर जो जाता है वह अक्सर इनबॉक्स में पहुँचे संस्करण से थोड़ा अलग होता है।
Okou एक हफ़्ते के मर्ज को प्रकाशित चेंजलॉग में कैसे बदलता है
चरण 1: अपने tools कनेक्ट करें
चरण 2: Okou से पूछें
चरण 3: इसे और आगे ले जाएँ
चेंजलॉग ऑटोमेशन के लिए GitHub, Resend, X और Slack इंटीग्रेशन
यह वर्कफ़्लो एक टूल से पढ़ता है और तीन में लिखता है। क्या रिलीज़ हुआ, इसका एकमात्र स्रोत GitHub है; Resend और X गंतव्य हैं; Slack वह जगह है जहाँ ड्राफ़्ट किसी व्यक्ति का इंतज़ार करता है। हर कनेक्टर अलग से दिया जाता है और सिर्फ़ उतने तक सीमित रहता है जितना वर्कफ़्लो सचमुच इस्तेमाल करता है, इसलिए आपकी रिपॉज़िटरी तक पढ़ने की अनुमति कभी भी आपके अकाउंट से पोस्ट करने का अधिकार नहीं बनती।
GitHub इंटीग्रेशन: चेंजलॉग बनाने के लिए Okou क्या पढ़ता है
ज़रूरीOkou आपकी तय अवधि में बताए गए रिपॉज़िटरी में मर्ज हुए पुल रिक्वेस्ट निकालता है और हर एक का शीर्षक, विवरण, लेबल, मर्ज का समय, लेखक और बदले गए फ़ाइल पाथ पढ़ता है। यही पाँच संकेत उपयोगकर्ता से जुड़े बदलाव को आंतरिक रीफ़ैक्टर से अलग करते हैं: रिलीज़-नोट लेबल सबसे मज़बूत है, बदले गए पाथ उन्हें पकड़ते हैं जिन पर किसी ने लेबल नहीं लगाया, और विवरण वह ब्योरा देता है जो शीर्षक में नहीं आता। इस वर्कफ़्लो में GitHub इंटीग्रेशन केवल पढ़ने के लिए है। Okou न कोई इशू खोलता है, न कमिट करता है, न पुल रिक्वेस्ट संपादित करता है। एक से ज़्यादा रिपॉज़िटरी बताएँ तो वह सबको एक ही बार में पढ़ता है, इसलिए अलग-अलग फ़्रंटएंड और बैकएंड होने पर भी चेंजलॉग एक ही बनता है।
Resend इंटीग्रेशन: Okou कौन-सा न्यूज़लेटर भेजता है
ज़रूरीOkou आपकी Resend ऑडियंस पढ़ता है ताकि आप जिसे नाम से बताएँ उसी को संबोधित कर सके, ID से नहीं, फिर कैंपेन बनाकर भेजता है: सब्जेक्ट, प्रीहेडर, HTML बॉडी और सादा-टेक्स्ट विकल्प। भेजने के बाद वह नतीजा दोबारा पढ़ता है और बताता है कि कितने संदेश डिलीवर हुए, कितने टले और कितने बाउंस हुए। इसी वजह से रिपोर्ट और कैंपेन के आँकड़े कभी अलग नहीं होते। भेजने की अनुमति ऑडियंस पढ़ने के एक्सेस से अलग दी जाती है, और Okou कभी कोई संपर्क जोड़ता, हटाता या निर्यात नहीं करता।
X इंटीग्रेशन: Okou कौन-सा थ्रेड पोस्ट करता है
ज़रूरीथ्रेड X के लिए लिखा जाता है, ब्लॉग पोस्ट को काटकर नहीं: हर थीम के लिए एक पोस्ट, एक शुरुआती पोस्ट जो बताती है क्या बदला, और एक अंतिम पोस्ट जो पूरे लेख से जोड़ती है। Okou हर प्रविष्टि को पिछली का जवाब बनाकर पोस्ट करता है ताकि थ्रेड जुड़ा रहे, और पोस्ट कटने देने के बजाय पहले ही लंबाई जाँच लेता है। लिखने की अनुमति सिर्फ़ आपके जोड़े गए अकाउंट तक सीमित है और वह केवल थ्रेड पोस्ट करता है। Okou आपकी टाइमलाइन, मेंशन या डायरेक्ट मैसेज नहीं पढ़ता।
Slack इंटीग्रेशन: जहाँ ड्राफ़्ट मंज़ूरी का इंतज़ार करता है
वैकल्पिकSlack वैकल्पिक है और मंज़ूरी वाले चरण में काम आता है। Okou आपके बताए चैनल में पूरा ड्राफ़्ट पोस्ट करता है, जिसमें ब्लॉग की सामग्री, ईमेल की सब्जेक्ट लाइन और थ्रेड की हर पोस्ट शामिल है, और फिर रुक जाता है। जब तक कोई मंज़ूरी नहीं देता, कुछ भी प्रकाशित नहीं होता, और आप उसी थ्रेड में दोबारा लिखने को कह सकते हैं तथा वहीं अपडेटेड ड्राफ़्ट पा सकते हैं। Slack के बिना भी वर्कफ़्लो पूरा चलता है; ड्राफ़्ट वहीं लौटता है जहाँ से आपने रन शुरू किया था।
Okou बनाम हाथ से लिखना बनाम चेंजलॉग जेनरेटर
चेंजलॉग ऑटोमेशन दो समस्याओं में बँटता है: यह तय करना कि घोषणा के लायक क्या है, और उस घोषणा को हर चैनल तक पहुँचाना। ज़्यादातर टूल इनमें से सिर्फ़ एक हल करते हैं।
हाथ से लिखना
कोई मर्ज की सूची पढ़ता है, तय करता है कि क्या मायने रखता है, पोस्ट लिखता है और फिर ईमेल तथा X के लिए उसे दो बार दोबारा लिखता है। समझ अच्छी होती है और भाषा ब्रांड जैसी, पर हर हफ़्ते वही 90 मिनट लगते हैं और व्यस्त हफ़्ते में यही काम सबसे पहले छूटता है।
चेंजलॉग जेनरेटर
कमिट या पुल रिक्वेस्ट के शीर्षक अपने आप एक रिलीज़-नोट पेज में जमा हो जाते हैं। कोई मर्ज छूटता नहीं, पर वह थीम के बजाय शीर्षक प्रकाशित करता है, रीफ़ैक्टर और फ़ीचर में फ़र्क नहीं कर पाता, और एक ही गंतव्य पर रुक जाता है।
Okou का चेंजलॉग वर्कफ़्लो
Okou वही मर्ज पढ़ता है, उपयोगकर्ता से जुड़े होने का आपका नियम लगाता है, बाकी को थीम में समूहित करता है और हर चैनल के लिए अलग लेखन करता है। ब्लॉग, Resend और X एक ही मंज़ूर ड्राफ़्ट से एक ही रन में प्रकाशित होते हैं, और रन बताता है कि उसने क्या रोका और क्यों।
बेहतर परिणामों के लिए सुझाव
अक्सर पूछे जाने वाले सवाल
GitHub पुल रिक्वेस्ट से चेंजलॉग कैसे ऑटोमेट करें?
GitHub को Okou से जोड़ें और उसे एक शेड्यूल या रिलीज़ ट्रिगर दें। Okou आपकी अवधि में मर्ज हुए पुल रिक्वेस्ट पढ़ता है, उपयोगकर्ता से जुड़े होने के आपके नियम से छाँटता है, बचे हुए को थीम में समूहित करता है और चेंजलॉग पोस्ट लिखता है। Resend और X जोड़ दें तो वही रन उसे इन चैनलों पर भी प्रकाशित कर देता है।
Okou कैसे तय करता है कि कौन-से मर्ज उपयोगकर्ता से जुड़े हैं?
आपके दिए नियम से, जो चार संकेतों पर लगाया जाता है: रिलीज़-नोट लेबल, बदले गए फ़ाइल पाथ, पुल रिक्वेस्ट का शीर्षक और उसका विवरण। लेबल सबसे मज़बूत संकेत है और ज़्यादातर टीमें उसी को मानक बनाती हैं। Okou जो कुछ भी छोड़ता है वह कारण सहित रन रिपोर्ट में दिखता है, इसलिए ग़लत आकलन छिपा नहीं रहता।
क्या एक ही ड्राफ़्ट न्यूज़लेटर और X पर एक साथ प्रकाशित हो सकता है?
हाँ। Okou थीम एक बार लिखता है, फिर हर चैनल के लिए ढालता है: ब्लॉग पर पूरी पोस्ट, सब्जेक्ट और प्रीहेडर के साथ इनबॉक्स-लायक लंबाई का ईमेल, और हर थीम के लिए एक पोस्ट वाला थ्रेड। तीनों एक ही मंज़ूर ड्राफ़्ट से एक ही रन में प्रकाशित होते हैं, इसलिए चैनलों के बीच तथ्य अलग नहीं हो सकते।
क्या मेरी मंज़ूरी के बिना कुछ प्रकाशित होता है?
जब तक आप कहें नहीं, नहीं। डिफ़ॉल्ट प्रवाह में Okou ड्राफ़्ट किसी चैनल में पोस्ट करके इंतज़ार करता है। आप उसे मंज़ूरी दे सकते हैं, उसी थ्रेड में दोबारा लिखवा सकते हैं या छोड़ सकते हैं। अगर आप बिना निगरानी प्रकाशन चाहते हैं तो प्रॉम्प्ट में यह कह दें और Okou मंज़ूरी वाला चरण छोड़ देगा।
इस चेंजलॉग ऑटोमेशन के लिए कौन-से टूल चाहिए?
क्या रिलीज़ हुआ, इसके स्रोत के रूप में GitHub ज़रूरी है। दोनों प्रकाशन गंतव्यों के लिए Resend और X ज़रूरी हैं। Slack वैकल्पिक है और सिर्फ़ मंज़ूरी वाले चरण में इस्तेमाल होता है; उसके बिना ड्राफ़्ट वहीं लौटता है जहाँ से आपने रन शुरू किया था।
इस वर्कफ़्लो को कौन-सी अनुमतियाँ चाहिए?
GitHub को उन रिपॉज़िटरी तक पढ़ने की अनुमति चाहिए जहाँ से आप प्रकाशित करते हैं। Resend को भेजने की अनुमति और ऑडियंस पढ़ने का एक्सेस चाहिए। X को उस अकाउंट पर लिखने की अनुमति चाहिए जो थ्रेड पोस्ट करता है। Slack इस्तेमाल करें तो उसे मंज़ूरी वाले चैनल में पोस्ट करने की अनुमति चाहिए। हर कनेक्टर Okou में अलग से दिया जाता है, और एक को रद्द करने पर बाकी अछूते रहते हैं।
क्या Okou कई रिपॉज़िटरी से एक ही चेंजलॉग बना सकता है?
हाँ। प्रॉम्प्ट में हर रिपॉज़िटरी का नाम दें और Okou उन सबको एक ही बार में पढ़ेगा, फिर बदलावों को इस आधार पर समूहित करेगा कि व्यवहार में क्या बदला, न कि वे किस रिपॉज़िटरी से आए। अलग-अलग फ़्रंटएंड और बैकएंड होने पर भी पोस्ट एक ही बनती है।
क्या साप्ताहिक शेड्यूल की जगह रिलीज़ टैग पर चला सकते हैं?
हाँ। ऐसा ऑटोमेशन बनाएँ जो GitHub में रिलीज़ टैग होते ही वर्कफ़्लो शुरू करे। तब Okou तारीख़ की अवधि के बजाय उस रिलीज़ के पुल रिक्वेस्ट से चेंजलॉग बनाता है, और बाक़ी रन बिल्कुल वैसा ही रहता है।
इस हफ़्ते का चेंजलॉग प्रकाशित करें
GitHub, Resend और X जोड़ें, फिर साप्ताहिक प्रॉम्प्ट से पूरा रन देखें: जाँच, समूहन, ड्राफ़्ट, मंज़ूरी, प्रकाशन।