GitHub issue’ları
Bir görevden GitHub issue’su oluşturun, müşteriyi gizli tutun ve görev ile issue’yu birlikte güncel tutun.
Bir hata bildirimi kodunuzda düzeltme gerektirdiğinde, görevini hiçbir şeyi yeniden yazmadan bir GitHub issue’suna çevirebilirsiniz. Görevin nasıl oluştuğu için E-postadan görevler sayfasına bakın.
Başlamadan önce
Bölüm başlığı “Başlamadan önce”- GitHub bağlı ve istediğiniz depo bir projeye bağlı.
- Görev bir e-postadan gelmiş olmalı. Düğme görevin E-postadan bölümündedir; yani Plavn’ın e-postadan hazırladığı görevlerde ve bir e-postadan Göreve çevir ile yaptığınız görevlerde bulunur. Yinelenen görevlerde gösterilmez.
- Plavn GitHub Uygulaması issue oluşturabilmelidir. Oluşturamıyorsa Plavn neyi değiştireceğinizi söyler (bkz. Oluşturma başarısız olursa).
Issue oluşturun
Bölüm başlığı “Issue oluşturun”- Görevi açın ve E-postadan altında GitHub issue oluştur’u seçin.
- Depo’yu seçin. Yalnızca bağlı depolar sunulur; şüpheli commit’leri içerenler başta, sonra görevin projesine bağlı olanlar gelir. Hiç yoksa Plavn önce Ayarlar → GitHub’da bir depo bağlamanızı söyler.
- Başlığı (iletişim kutusunda Title) ve açıklamayı (Description (Markdown)) düzenleyin. Görevin başlığı ve oluşturulmuş bir açıklama hazır gelir. Bu iki etiket şimdilik İngilizce görünür.
- Issue oluştur’u seçin.
Görev bundan sonra issue’yu acme/app#42 gibi küçük bir bağlantı ve açık ya da kapalı ile gösterir. Her görevin
en fazla bir issue’su olur.
Açıklamada neler var
Bölüm başlığı “Açıklamada neler var”- Report (bildirim): müşterinin e-postası, alıntı olarak (yazışmadaki önceki iletiler olmadan ve ilk 4.000 karakterle sınırlı). E-postadan gelmeyen bir görevde bunun yerine görevin açıklaması.
- Analysis (analiz): Plavn’ın e-postadan çıkardığı.
- Suspect commits (şüpheli commit’ler), güvenle birlikte; her biri commit’e bağlanır ve neden şüpheli olduğunu söyler.
- Created from Plavn diyen ve göreve geri bağlanan kapanış satırı.
Issue’yu oluşturmadan önce hepsini değiştirebilirsiniz; gönderdiğiniz şey yayımlanır. Bölüm başlıkları issue’da İngilizce yazılır.
Müşteriyi gizli tutun
Bölüm başlığı “Müşteriyi gizli tutun”Issue’lar çoğu zaman herkese açık olduğundan Plavn varsayılan olarak müşteriyi tanıtan her şeyi bildirimden ve analizden çıkarır:
| Çıkarılan | Yerine konan |
|---|---|
| E-posta adresleri | [email] |
| Telefon numaraları | [phone] |
| Jeton, anahtar, kod ya da imza taşıyan bağlantılar | [link] |
| Gönderenin adı (her parçası) | [name] |
Issue, bildirimin “e-postayla” geldiğini ve gönderenin gizli tutulduğunu söyler.
Eklemek için Gönderenin adını ve adresini ekle’yi işaretleyin. Açıklama o zaman bildirimi yazıldığı gibi ve kimin gönderdiğiyle gösterir. Issue’yu oluşturmadan önce açıklamada kalanlara bakın: Plavn bariz tanıtıcıları çıkarır, ama bir müşterinin yazabileceği her şeyi bilemez.
Görevi ve issue’yu birlikte tutmak
Bölüm başlığı “Görevi ve issue’yu birlikte tutmak”- GitHub’dan Plavn’a. Issue GitHub’da kapatıldığında, yeniden açıldığında ya da açıldığında görev bunu gösterir. “Fixes #42” diyen bir pull request birleştirildiğinde issue’yu kapatır; yani birleştirilen düzeltmeler de buraya ulaşır.
- Plavn’dan GitHub’a. Açık issue’su olan bir görevi tamamladığınızda Plavn issue’yu kapatabilir. İlk seferde GitHub issue’su da kapatılsın mı? sorusuna yanıt verirsiniz ve Her seferinde böyle yap’ı işaretleyebilir ya da Ayarlar → Geliştirici altında Açık issue’su olan bir görevi tamamladığımda için Bana sor, Issue’yu kapat ya da Açık bırak’ı seçebilirsiniz. Bu seçim yalnızca bu cihazda kaydedilir. Çevrimdışıyken kapatma bekler ve çevrimiçi olunca gönderilir. Plavn issue’yu tamamlandı olarak kapatır.
- Müşteriyi bilgilendirmek. E-postadan gelen bir görev tamamlandığında ya da issue’su kapandığında Plavn, göndereni işin bittiğinden haberdar eden kısa bir yanıt hazırlayabilir. Bkz. E-postadan görevler.
Oluşturma başarısız olursa
Bölüm başlığı “Oluşturma başarısız olursa”- “The Plavn GitHub App cannot create issues yet…” (Plavn GitHub Uygulaması henüz issue oluşturamıyor.) Uygulama’nın issue yazma izni olmalı. GitHub’da Uygulama’nın izinlerini açın, Issues’u Read and write yapın ve güncellemeyi hesabınızda ya da organizasyonunuzda kabul edin. Bu ileti şimdilik İngilizcedir.
- Bulunamadı ya da erişim yok. Depo Uygulama’dan kaldırılmış ya da Uygulama silinmiş olabilir. GitHub’ı bağlayın sayfasına bakın.
- Plavn GitHub’a ulaşamıyor. Biraz sonra tekrar deneyin.
Issue oluşturmak bağlantı gerektirir. Plavn, GitHub hesabınızı korumak için issue oluşturma hızını sınırlar.