İçeriğe geç

Bug raporu şablonu: ücretsiz, Jira, GitHub ve Linear için

Kopyala-yapıştır ücretsiz bug raporu şablonu, GitHub, Linear ve Jira için hazır sürümler, bir GitHub issue formu ve doldurulmuş bir örnek.

Bug raporu şablonu (ya da hata raporu şablonu), her raporun aynı soruları yanıtlamasını sağlayan sabit bir alan setidir: ne bozuldu, nerede, nasıl yeniden üretilir, ne olması gerekiyordu ve bunu hangi kanıt gösteriyor. Aşağıdaki şablon başlık, özet, ortam, yeniden üretme adımları, beklenen ve gerçekleşen sonuç, sıklık, önem derecesi, ekler ve logları kapsıyor. Onu hata takip aracına, bir destek formuna ya da bir sohbet mesajına kopyala ve boşlukları doldur. Daha aşağıda GitHub, Linear ve Jira için hazır sürümler var, bir GitHub issue formu da dahil.

Şablonlar var, çünkü geliştiriciler zamanlarının çoğunu düzeltmeye değil, eksik ayrıntılara harcar. Tam adımları, tarayıcı sürümünü ve konsol hatasını içeren bir rapor çoğu zaman aynı gün düzeltilebilir. "Ödeme sayfası bozuk" diyen bir rapor ise uzun bir soru-cevap zincirine dönüşür.

Şablon

Başlık: [sayfa ya da özellik] üzerinde [eylem] yapınca [bozulan şey]

Özet
Sade bir dille bir iki cümle. Ne oldu ve kimler etkileniyor.

Ortam
- URL:
- Tarayıcı ve sürümü:
- İşletim sistemi:
- Cihaz / ekran boyutu:
- Uygulama sürümü ya da build (biliniyorsa):
- Hesap / rol / test kullanıcısı:
- Olduğu tarih ve saat (saat dilimiyle):

Yeniden üretme adımları
1.
2.
3.

Beklenen sonuç
Ne olması gerekiyordu.

Gerçekleşen sonuç
Onun yerine ne oldu. Hata mesajını metin olarak, birebir kopyala.

Sıklık
Her zaman / Bazen (yaklaşık Y denemede X) / Bir kez oldu

Önem derecesi
Engelleyici / Büyük / Küçük / Kozmetik

Geçici çözüm
Sorunu aşmanın bir yolu ya da "Bulunamadı".

Ekler
- Ekran görüntüsü ya da ekran kaydı:
- Konsol hataları:
- Başarısız olan ağ isteği (URL, durum, yanıt):
- HAR dosyası (temizlenmiş), istendiyse:

Notlar
Başka her şey: ne zaman başladı, son zamanlarda ne değişti, ilgili kayıtlar.

Her alan nasıl doldurulur

Başlık

Başlık, insanların elli kayıtlık bir listede göz gezdirdiği şeydir; bu yüzden onu belirgin yap. İşe yarayan bir kalıp: "ne bozuk" artı "ne zaman" artı "nerede". "Ödeme sayfasında geçerli bir kart girildikten sonra Öde düğmesi devre dışı kalıyor", "Ödeme bug'ı"ndan çok daha iyidir. "Acil" ya da "bozuk" gibi kelimeleri tek başına kullanma; bunu önem derecesi alanı taşır.

Özet

Teknik olmayan bir ekip arkadaşının anlayabileceği bir iki cümle. Biliyorsan kimin etkilendiğini söyle: tüm kullanıcılar, yalnızca adminler, yalnızca Safari kullanıcıları, yalnızca tek bir müşteri.

Ortam

Pek çok bug tarayıcıya, cihaza, hesaba ya da veriye bağlıdır. Tam URL'yi, tarayıcının adını ve sürümünü, işletim sistemini ve kullandığın hesabı ya da rolü yaz. Uygulama bir sürüm ya da build numarası gösteriyorsa onu da ekle. Hatanın zamanı, saat dilimiyle birlikte, geliştiricinin sunucu loglarındaki ilgili kayıtları bulmasını sağlar.

Yeniden üretme adımları

En önemli alan bu. Adımları numaralandır, bilinen bir durumdan başla ("sepeti boş bir kullanıcı olarak giriş yapılmış") ve kullandığın verinin tam hâlini yaz. Her adıma tek bir eylem yaz. Sorunu ikinci kez üretemediysen bunu söyle ve ilk seferde ne yaptığını olabildiğince yakın anlat.

Beklenen sonuç ve gerçekleşen sonuç

İkisini yan yana tut ki aradaki fark açıkça görünsün. Hata mesajlarını kendi cümlelerinle anlatmak yerine metin olarak kopyala; geliştirici kodda tam olarak o metni arayacak. "Hiçbir şey olmuyor" geçerli bir gerçekleşen sonuçtur, ama neyi kontrol ettiğini de ekle; örneğin "hata mesajı yok, düğme etkin kalıyor".

Sıklık

"Her zaman" olan bug'lar düzeltmesi en kolay olanlardır. "Bazen" olan bug'lar daha fazla veri ister; bu yüzden oranı tahmin et ("10 denemede 3") ve yavaş bağlantı ya da büyük bir dosya gibi önemli görünen her şeyi not et.

Önem derecesi

Önem derecesi etkiyle ilgilidir, ne kadar sinirlendiğinle değil. Yaygın bir ölçek:

Önem derecesiAnlamıÖrnek
Engelleyici (Blocker)Temel akış imkânsız, geçici çözüm yokKimse giriş yapamıyor
Büyük (Major)Önemli bir özellik bozuk ya da veri yanlış, geçici çözüm zahmetliFaturalar yanlış toplamı gösteriyor
Küçük (Minor)Özellik küçük bir sorunla ya da kolay bir geçici çözümle çalışıyorSayfa yenilenince sıralama sıfırlanıyor
Kozmetik (Cosmetic)Görsel sorun, işlevsel etkisi yokKüçük ekranlarda düğme metni taşıyor

Ne zaman düzeltileceğine karar veren öncelik ise genellikle raporu yazan kişi tarafından değil, backlog'un sahibi olan ekip tarafından belirlenir.

Geçici çözüm

Geçici çözüm, ekibe düzeltmenin ne kadar acil olduğunu söyler ve bu arada destek ekibinin müşterilere yanıt vermesine yardım eder.

Ekler ve loglar

En çok zamanı kanıt kazandırır. Sorunlu bölgesi işaretlenmiş bir ekran görüntüsü ya da adımları gösteren kısa bir ekran kaydı ekle. Web uygulamaları için konsol hatalarını ve başarısız ağ isteğini de ekle. Chrome'da konsol loglarını dışa aktarma ve Chrome'da ağ trafiğini yakalama rehberlerimiz nasıl yapılacağını gösteriyor. Biri senden HAR dosyası isterse HAR dosyası nasıl alınır rehberini izle ve dosyayı önce HAR temizleyici ile temizle; çünkü HAR dosyaları çerezler ve token'lar içerir.

Doldurulmuş bir örnek

Başlık: Ödeme sayfasında geçerli bir kart girildikten sonra Öde düğmesi devre dışı kalıyor

Özet
Ödeme sayfasında geçerli bir test kartı girildikten sonra Öde düğmesi hiç
tıklanabilir hâle gelmiyor, bu yüzden sipariş verilemiyor. Chrome ve Edge'de görüldü.

Ortam
- URL: https://staging.example.com/checkout
- Tarayıcı ve sürümü: Windows 11'de Chrome 154; ayrıca Edge 154
- Cihaz / ekran boyutu: Dizüstü, 1920x1080
- Uygulama sürümü ya da build: web 4.18.0 (sayfa altı)
- Hesap / rol / test kullanıcısı: [email protected], standart müşteri
- Tarih ve saat: 2026-11-10 14:32 CET

Yeniden üretme adımları
1. [email protected] olarak giriş yap.
2. Sepete "Starter plan, yıllık" ekle.
3. /checkout sayfasına git.
4. 4242 4242 4242 4242 test kartını, son kullanma 12/30, CVC 123 ile gir.
5. Kart alanının dışına tıkla.

Beklenen sonuç
Öde düğmesi etkinleşir ve "120,00 $ Öde" yazar.

Gerçekleşen sonuç
Öde düğmesi gri ve devre dışı kalıyor. Hiçbir hata mesajı gösterilmiyor.
Konsolda şu yazıyor: Uncaught TypeError: Cannot read properties of
undefined (reading 'postalCode') at validateCard (checkout.js:214)

Sıklık
Her zaman (5 denemede 5)

Önem derecesi
Engelleyici: müşteriler ödeme yapamıyor

Geçici çözüm
Bulunamadı. Production build 4.17.2'de çalışıyor.

Ekler
- Ekran kaydı: bağlantı yorumlarda
- Konsol hataları: checkout-console.log
- Ağ: POST /api/cart/validate 200 döndü; başka başarısız istek yok

Notlar
Bu sabahki staging deploy'undan sonra başladı.

Bu örneği işe yarar kılan şeylere dikkat et. Adımlar bilinen bir hesaptan başlıyor. Test kartı açıkça belirtilmiş. Konsol hatası birebir alıntılanmış. Raporu yazan kişi başka bir tarayıcıyı ve önceki build'i de denemiş; bu da nedeni şimdiden son değişikliğe daraltıyor.

Daha kısa sürümler

Her bug her alanı gerektirmez. Ekip sohbetinde hızlı bir mesaj için kısa bir sürüm yeterlidir:

Bug: [başlık]
Nerede: [URL], [tarayıcı/işletim sistemi]
Adımlar: 1) ... 2) ... 3) ...
Beklenen: ...
Gerçekleşen: ...
Kanıt: [ekran görüntüsü / kayıt / konsol hatası]

Bir kullanıcının raporunu ileten müşteri destek ekipleri için müşterinin hesap kimliğini, destek kaydının bağlantısını ve müşterinin kendi sözlerini ekle; hangi kısımları kendin yeniden ürettiğini de belirt.

QA test koşuları için test senaryosu kimliğini ve test edilen build'i ekle; böylece bug onu bulan teste geri bağlanır.

GitHub, Linear ve Jira için şablonlar

Düz metin şablonu her yerde çalışır. Hata takip aracın Markdown işliyorsa bu sürüm başlıkları ve kontrol listelerini okunur tutar:

## Özet
<!-- Bir iki cümle: ne oldu ve kimler etkileniyor. -->

## Ortam
- URL:
- Tarayıcı ve sürümü:
- İşletim sistemi:
- Uygulama sürümü ya da build:
- Hesap / rol:

## Yeniden üretme adımları
1.
2.
3.

## Beklenen sonuç

## Gerçekleşen sonuç
<!-- Hata mesajını metin olarak, birebir yapıştır. -->

## Sıklık
<!-- Her zaman / Bazen (Y denemede X) / Bir kez -->

## Önem derecesi
<!-- Engelleyici / Büyük / Küçük / Kozmetik -->

## Kanıt
- [ ] Ekran görüntüsü ya da ekran kaydı
- [ ] Konsol hataları
- [ ] Başarısız olan ağ isteği

GitHub Issues

Markdown sürümünü deponda .github/ISSUE_TEMPLATE/bug_report.md olarak kaydet ve başına kısa bir başlık ekle; böylece GitHub onu "New issue" seçicisinde sunar:

---
name: Bug raporu
about: Bir şey bozuk
labels: bug
---

GitHub ayrıca issue formlarını da destekler; bunlar şablonu, insanların atlayamayacağı etiketli alanlara dönüştürür. Bunu .github/ISSUE_TEMPLATE/bug_report.yml olarak kaydet:

name: Bug raporu
description: Bir şey bozuk
labels: ["bug"]
body:
  - type: textarea
    id: summary
    attributes:
      label: Özet
      description: Ne oldu ve kimler etkileniyor?
    validations:
      required: true
  - type: input
    id: url
    attributes:
      label: URL
  - type: input
    id: environment
    attributes:
      label: Tarayıcı, işletim sistemi ve uygulama sürümü
      placeholder: macOS 26'da Chrome 154, web 4.18.0
  - type: textarea
    id: steps
    attributes:
      label: Yeniden üretme adımları
      value: |
        1.
        2.
        3.
    validations:
      required: true
  - type: textarea
    id: expected
    attributes:
      label: Beklenen sonuç
    validations:
      required: true
  - type: textarea
    id: actual
    attributes:
      label: Gerçekleşen sonuç
      description: Hata mesajını metin olarak, birebir yapıştır.
    validations:
      required: true
  - type: dropdown
    id: severity
    attributes:
      label: Önem derecesi
      options:
        - Engelleyici
        - Büyük
        - Küçük
        - Kozmetik
  - type: textarea
    id: evidence
    attributes:
      label: Ekran görüntüleri, kayıt ve loglar
      description: Dosyaları buraya sürükle ya da bir kaydın bağlantısını yapıştır.

Linear

Linear'da kayıt şablonları ekibin ayarlarında bulunur. "Bug" adında bir şablon oluştur, Markdown sürümünü açıklamasına yapıştır, Bug etiketini ve ekibin triage durumunu seç; böylece her rapor aynı alanlarla başlar.

Jira

Jira'da düz metin ya da Markdown sürümünü yeni bir Bug'ın açıklamasına yapıştır. Jira Cloud'da her kayıt türü için yerleşik bir varsayılan açıklama yok; bu yüzden şablonun önceden dolu gelmesini isteyen ekipler Atlassian Marketplace'ten bir issue şablonu uygulaması kullanır. Konsol ve ağ loglarını içeren bir ekran kaydının bağlantısı açıklamaya ya da bir yoruma eklenir.

Şablonun önlediği hatalar

Bir şablon büyük ölçüde hep aynı birkaç hataya karşı bir kontrol listesidir:

  • Tek raporda birden çok bug. Her sorun için bir kayıt; böylece her biri kendi başına düzeltilip test edilip kapatılabilir.
  • Kendi cümlelerinle aktarılmış hatalar. "Yetkilerle ilgili bir şey yazıyordu" aranamaz. Mesajın tam hâli aranabilir.
  • Eksik başlangıç noktası. Bir akışın ortasından başlayan adımlar yalnızca onları yazan kişi için işe yarar.
  • Gözlem yerine görüş. "API bozuk" bir tahmindir. "POST /api/orders 500 döndü" ise geliştiricinin kontrol edebileceği bir gerçektir.
  • Eklerde gizli bilgiler. Admin panellerinin ekran görüntüleri, HAR dosyaları ve konsol logları token'lar ve müşteri verileri içerebilir. Eklemeden önce kırp, bulanıklaştır ya da temizle.

Ekibinin varsayılanı yap

Çoğu hata takip aracı varsayılan bir açıklama ya da kayıt şablonu kaydetmene izin verir; böylece her yeni bug bu başlıklarla başlar. Şablonu, insanların gerçekten dolduracağı kadar kısa tut. Bir alan çoğu raporda boş kalıyorsa onu kaldır. Geliştiriciler hep aynı takip sorusunu soruyorsa onun için bir alan ekle.

Teknik alanları araç doldursun

İnsanların en sık atladığı alanlar teknik olanlardır: tarayıcı sürümü, konsol hataları, başarısız istek. Ücretsiz bir Chrome eklentisi olan Midge, bunları bir ekran kaydına ya da ekran görüntüsüne otomatik olarak ekler; böylece raporu yazan kişi yalnızca başlığı, adımları ve beklenen sonucu yazar. Her kayıtta konsol logları, ağ istekleri, kullanıcı adımları ve cihaz bilgileri var. Şifreler, kart numaraları, token'lar ve çerezler, hiçbir şey cihazından çıkmadan önce tarayıcında maskelenir. Bir rapor doğrudan Jira, Linear, GitHub Issues ya da Slack'e gider ya da istediğin yere yapıştırabileceğin bir bağlantı olarak paylaşılır.

İlgili rehberler

Sık sorulan sorular

Bir bug raporu şablonu neleri içermeli?

Net bir başlık, ortam (URL, tarayıcı, işletim sistemi, uygulama sürümü, hesap), numaralı yeniden üretme adımları, beklenen sonuç, gerçekleşen sonuç, ne sıklıkla olduğu, önem derecesi ve ekran görüntüleri, video, konsol logları ve ağ istekleri gibi kanıtlar.

Bu şablonu Jira, Linear ya da GitHub Issues'ta kullanabilir miyim?

Evet. Markdown uyumlu başlıklara sahip düz bir metin; bu yüzden onu herhangi bir takip aracına yapıştırabilirsin. GitHub ve Linear onu kayıt şablonu olarak da kaydedebilir, Jira ise bir Marketplace uygulamasıyla.

GitHub issue şablonları nereye konur?

Deponun .github/ISSUE_TEMPLATE klasörüne. Bir .md dosyası Markdown şablonu, bir .yml dosyası ise zorunlu alanları olan bir issue formu ekler. Biri yeni bir issue açtığında GitHub onları listeler.

Önem derecesi ile öncelik arasındaki fark nedir?

Önem derecesi, bug'ın ürünü ya da kullanıcıları ne kadar kötü etkilediğini anlatır. Öncelik ise ekibin onu ne kadar yakında düzelteceğini. Nadiren kullanılan bir admin ekranındaki ciddi bir bug, fiyatlandırma sayfasındaki kozmetik bir bug'dan daha düşük önceliğe sahip olabilir.

Her alanı doldurmam gerekiyor mu?

Hayır. Başlık, adımlar, beklenen ve gerçekleşen sonuç şart. Gerisini bildiğinde doldur; bilmediğin yerde tahmin yürütmek yerine "bilinmiyor" yaz.