Slack Hata Raporundan GitHub Düzeltmesine
Slack'de bir hatayı düz metinle açıklayın. Okou, GitHub sorununu yazar ve atar ve neden tek bir bileşende olduğunda, düzeltme ve incelemeniz için bir regresyon testi içeren bir çekme isteği açar.
Okou'nin sundukları: bir Slack mesajından incelemedeki bir düzeltmeye
Okou ekibinin #bug-report kanalından, olduğu gibi yakalanmış gerçek bir konu. Bir ekip arkadaşı bir müşterinin raporunu yapıştırdı ve bir düzeltme istedi. Dört dakika sonra Okou, GitHub sorununu bir teşhisle birlikte kaydetti. İlk mesajdan on dört dakika sonra çekme isteğini açtı ve önizleme bağlantısını yayınladı. Aşağıda her iki yakalama da bulunmaktadır: başladığı konu ve Okou'nin yazdığı çekme isteği. Bunlar herkese açıktır, böylece sorunu, farkı ve incelemeyi kendiniz okuyabilirsiniz.
Konuşmada ne oldu
Bir ekip arkadaşı, #bug-report'ta bir müşterinin PWA düzen hatasını bildirdi ve ekran görüntülerini ekledi. Okou, konuyu okudu, iOS güvenli alan eklemesi olmadan oluşturulan bir üst çubuğa kadar izledi ve etiketler ve akıl yürütmesiyle #11708 numaralı sorunu açtı. Konu düzeltmeyi istediğinde, Okou bir dosyayı değiştirdi (mobil üst çubukta minimum yükseklik ve güvenli alan dolgusu), bir önizleme bağlantısıyla #11709 numaralı çekme isteğini açtı ve orada durdu. Bir kişi inceledi ve birleştirdi.
- Dosyalanmış soruna mesaj
- 4 dk#11708 numaralı sorun, hata ve PWA olarak etiketlendi
- Çekme isteğine mesaj
- 14 dkÖnizleme bağlantılı PR #11709
- Düzeltme ile değişen dosyalar
- 1Okou tarafından değil, bir kişi tarafından birleştirildi
Slack'den bir GitHub sorunu oluşturmak ne anlama geliyor?
Slack'den bir GitHub sorunu oluşturmak, birinin bir konuşmada tanımladığı bir hatayı, kimsenin yeniden yazmak için sohbetten ayrılmasına gerek kalmadan deponuzda düzgün bir şekilde yapılandırılmış bir soruna dönüştürmek anlamına gelir. Zor kısım asla API çağrısı değildi; açık bir başlık yazmak, yeniden üretme adımlarını beklenen davranıştan ayırmak, etiketleri seçmek, bir öncelik belirlemek ve doğru sahibini bulmaktır. Okou bu işi yapar. Slack mesajını ve etrafındaki yanıtları okur, sorun gövdesini yazar, belirleyebileceği etiketleri ve bir önceliği uygular, Slack görünen adını bir GitHub kullanıcı adıyla eşleştirerek atananı çözer ve rapor edenin bir bakışta kontrol edebilmesi için sorun bağlantısını aynı sohbete geri gönderir.
Hata raporları neden Slack iş parçacıklarında ölür?
Birisi bir demo sırasında bir hata fark eder veya bir müşteri Cumartesi günü yazar. Eski yol uzundur: GitHub'yi açın, depoyu bulun, biçimlendirilmiş bir sorun yazın, birine atayın, sonra o kişinin onu almasını, kodu okumasını ve düzeltmeyi yazmasını bekleyin. On dakikalık bir değişiklik, üç kişi arasında çok günlük bir gidiş-dönüşe dönüşür ve raporların yarısı asla konudan çıkmaz. Bunun yerine Slack'de açıklarsınız. Okou, sorunu yeniden üretme adımları, etiketler ve bir sahip ile dosyalar ve nedenin bulunduğu yerde, düzeltme ve bir test ile bir çekme isteği açar. Siz inceler ve gönderirsiniz.
Okou, Slack'den nasıl bir GitHub sorunu oluşturur
Adım 1: Araçlarınızı bağlayın
Adım 2: Okou'e sor
Adım 3: Daha ileri götür
İş akışının arkasındaki Slack ve GitHub entegrasyonları
Bu, ortasında bir ajan bulunan bir Slack GitHub entegrasyonudur: Okou, Slack'deki konuşmayı okur ve kaydı GitHub'ye yazar. Her bağlayıcı ayrı ayrı verilir ve iş akışının gerçekten kullandığı şeyle sınırlıdır, bu nedenle bir kanalı okumak asla depolarınıza yazma erişimi anlamına gelmez.
Slack entegrasyonu: Okou'nin okuduğu konuşma
GerekliOkou, işaret ettiğiniz mesajı ve etrafındaki yanıtları okur, böylece üç mesaj sonra gelen bağlam bile soruna dahil olur. Ekli ekran görüntülerini alır ve taşır, bir atananı çözmek için rapor edenin görünen adını okur ve mesajın kalıcı bağlantısını korur, böylece her sorun raporun başladığı yere geri bağlanır. Yazma tek bir şeydir: sorun numarası ve bağlantısıyla aynı konuda bir yanıt. Okou diğer kanallara gönderi yapmaz, DM göndermez veya kimsenin mesajlarını düzenlemez.
GitHub entegrasyonu: Okou'nin dosyalandığı sorun
GerekliOkou, belirttiğiniz depoda, ham mesajın bir kopyası yerine rapordan yazılmış bir başlık, bir açıklama, yeniden üretme adımları, beklenen davranış ve sohbetin birini adlandırdığı durumlarda etkilenen alan ile sorunu oluşturur. Belirttiğiniz etiketleri uygular veya kelime dağarcığından çıkarır, açıklayabileceği bir öncelik belirler ve sahibini atar. Dosyalamadan önce, aynı semptom için açık sorunları arar ve bir eşleşme bulduğunda mevcut olana yorum yapar. Hatayı da düzeltebildiğinde, bir dalı iter ve sorunu kapatan ve inceleme talep eden bir çekme isteği açar. Yazma erişimi, verdiğiniz depolarla sınırlıdır ve bu tüm yüzeydir: sorunlar, yorumlar ve inceleme için açılan çekme istekleri. Okou birleştirmez, zorla itmez veya depo ayarlarını değiştirmez.
Okou vs. GitHub uygulaması vs. bir otomasyon oluşturucu için Slack
Bir Slack mesajından GitHub'ye bir hata almak üç bölümden oluşur: raporu yakalamak, kullanılabilir bir sorun yazmak ve bir sahibine yönlendirmek. Mevcut seçeneklerin her biri bunlardan birini çözer.
Slack için GitHub uygulaması
/github yazmak, başlığı, gövdeyi, etiketleri ve atanan kişiyi kendinizin doldurduğu bir iletişim kutusu açar. Tarayıcıya gitme zahmetinden kurtarır, ancak sorunu hala siz yazıyorsunuz ve bir konuşmanın ortasındaki bir form, insanların "Daha sonra dosyalayacağım" demesine neden olan sürtünmenin ta kendisidir.
Bir otomasyon oluşturucu
Kodsuz bir oluşturucu, bir Slack mesajını bir tetikleyici üzerinde yeni bir soruna kopyalayabilir. Kopyaladığı şey ham mesajdır, bu nedenle sorun, rapor edenin yazdığı her şeyi miras alır ve etiketler, öncelik, atama ve kopyalar için kurallar, her kanal için tanımlamanız ve sürdürmeniz gereken kurallardır.
Okou'nin Slack-to-GitHub iş akışı
Okou konuyu okur ve sorunu yazar: gerçek bir başlık, beklenen davranıştan ayrılmış yeniden üretim adımları, haklı çıkarabileceği etiketler ve bir öncelik, ve rapor edenin görünen adından eşleştirilmiş bir atanan. Neden tek bir bileşenle sınırlı olduğunda, devam eder ve düzeltme ve bir regresyon testi ile bir çekme isteği açar, soruna bağlıdır ve incelemenizi bekler. Önce açık sorunları kontrol eder ve bir tane dosyalamak yerine bir kopyaya yorum yapar ve bağlantıyla birlikte konuya yanıt verir.
Daha iyi sonuçlar için ipuçları
Sıkça sorulan sorular
Bir Slack mesajından bir GitHub sorunu nasıl oluşturulur?
Slack ve GitHub'yi Okou'ye bağlayın, ardından hatayı kanalda açıklayın ve Okou'den bahsedin. Mesajı ve çevresindeki yanıtları okur, başlık, yeniden üretme adımları, beklenen davranış, etiketler ve öncelik içeren bir sorun yazar, adını verdiğiniz depoda oluşturur, bir sahip atar ve konu numarası ve bağlantısıyla birlikte konuda yanıt verir. Bir form doldurmazsınız.
Bu, Slack için GitHub uygulamasından nasıl farklı?
GitHub uygulaması size doldurmanız için bir iletişim kutusu verir: başlığı, gövdeyi, etiketleri ve atanan kişiyi hala siz yazarsınız. Okou bunları konuşmadan yazar, dosyalama yapmadan önce aynı semptomla mevcut bir sorunu kontrol eder ve tek seferlik bir mesaj yerine bir program dahilinde tüm bir kanalda çalışabilir.
Okou sadece sorunu mu dosyalar, yoksa hatayı düzeltebilir mi?
Her ikisi de, ve hangisini yaptığını ve nedenini size söyler. Okou her zaman sorunu dosyalar. Konu veya kod tek bir bileşeni işaret ettiğinde, beklenen davranış açık olduğunda ve başarısız bir test önce yazılabildiğinde, düzeltme ve o testle birlikte bir çekme isteği de açar, onu soruna bağlar ve inceleme ister. Paylaşılan yardımcı programlar, tasarım belirteçleri ve ürün kararı gerektiren her şey değiştirilmek yerine dosyalanır. Okou asla birleştirmez; her düzeltme, sizin incelediğiniz bir çekme isteği olarak gelir.
Okou sorunu otomatik olarak doğru kişiye atayabilir mi?
Evet. Okou, bahsettiğiniz adı veya raporlayıcının Slack görünen adını depodaki GitHub tanıtıcılarıyla eşleştirir ve sorunu atar. Mesajınızda atanan kişiyi belirtmek en güvenilir yoldur; kimse belirtilmediğinde, Okou, iş parçacığının işaret ettiği alanın sahibine geri döner ve sorunda nasıl karar verdiğini belirtir.
Okou yinelenen GitHub sorunlarını dosyalamaktan nasıl kaçınır?
Okou, herhangi bir şey oluşturmadan önce, aynı semptom, etkilenen alan ve ifade için açık sorunları arar. Bir eşleşme bulduğunda, yeni Slack konusunu, raporlayan ve zaman damgası ile o soruna bir yorum olarak ekler ve ikinci bir sorun açmak yerine Slack'de mevcut sorun bağlantısıyla yanıt verir.
Bir hata raporunda yeniden üretme adımları yoksa ne olur?
Okou yine de sorunu açar, böylece rapor kaybolmaz, çoğaltma adımlarına ihtiyaç duyduğunu etiketler ve Slack iş parçacığında raporu isteyerek yanıt verir. Cevap daha sonra sorundan zaten bağlantılı olan iş parçacığına düşer.
Okou, bir kanalın tamamından belirli bir programa göre hata bildirebilir mi?
Evet. Okou'yi bir veya daha fazla kanala yönlendirin ve ona bir program verin, örneğin her Cuma saat 16:00'da. Haftanın mesajlarını okur, bir kusuru açıklayan her biri için bir sorun açar, kopyaları yorumlar, özellik isteklerini ve soruları atlar ve ne yaptığını rapor eder.
Bu, GitHub yerine Linear veya Jira ile çalışır mı?
Aynı iş akışı şekli, Okou'nin bağlı olduğu herhangi bir izleyici için geçerlidir; bu sayfa, GitHub bağlayıcısını kullanan GitHub yolunu kapsar. Linear aynı şekilde bağlanır ve talimatta izleyiciyi adlandırırsınız.
Bir sonraki hatanızı Slack'den ayrılmadan bildirin
Slack ve GitHub'yi bağlayın, hatayı bir ekip arkadaşınıza anlatacağınız gibi açıklayın ve Okou'nin sorunu yazmasına ve atamasına izin verin. Neden kontrol altına alındığında, çekme isteği de sizi bekliyor olacaktır.
